fix: support items array for openai sdk

Former-commit-id: 4868cc2
Former-commit-id: 9b216c5b889523d772979976b9ee713766429ff1

Author: linhdmn

CHANGELOG.md

@@ -1,11 +1,21 @@
 # Changelog
 
-## [0.2.1] - 2023-03-31
+## [v1.6.1] - 2025-04-01
+
+### Added
+- OpenAI Agents SDK compatibility by adding Items property to array parameters
+- Test script for verifying OpenAI Agents SDK compatibility
+
+### Fixed
+- Issue #8: Array parameters in tool definitions now include required `items` property
+- JSON Schema validation errors in OpenAI Agents SDK integration
+
+## [v1.6.0] - 2023-03-31
 
 ### Changed
 - Upgraded cortex dependency from v1.0.3 to v1.0.4
 
-## [0.2.0] - 2023-03-31
+## [] - 2023-03-31
 
 ### Added
 - Internal logging system for improved debugging and monitoring
@@ -16,7 +26,7 @@
 - Restored functionality for all MCP tools
 - Eliminated non-JSON RPC logging in stdio mode
 
-## [0.1.0] - 2023-03-25
+## [] - 2023-03-25
 
 ### Added
 - Initial release of DB MCP Server

README.md

@@ -88,6 +88,7 @@ The server follows Clean Architecture principles with these layers:
 - **Simultaneous Multi-Database Support**: Connect to and interact with multiple MySQL and PostgreSQL databases concurrently
 - **Database-Specific Tool Generation**: Auto-creates specialized tools for each connected database
 - **Clean Architecture**: Modular design with clear separation of concerns
+- **OpenAI Agents SDK Compatibility**: Full compatibility with the OpenAI Agents SDK for seamless integration with AI assistants
 - **Dynamic Database Tools**: 
   - Execute SQL queries with parameters
   - Run data modification statements with proper error handling
@@ -568,4 +569,82 @@ If the AI assistant can't call the MCP tools:
 2. Verify your .cursor/mcp.json configuration is correct
 3. Ensure the server_name in .env matches what's in your MCP tool calls
 4. Restart Cursor after making configuration changes
-5. Check the logs in the logs/ directory for any errors
+5. Check the logs in the logs/ directory for any errors
+
+## OpenAI Agents SDK Integration
+
+The DB MCP Server fully supports OpenAI's Agents SDK, allowing you to create AI agents that can interact with databases directly.
+
+### Prerequisites
+
+- OpenAI account with API access
+- OpenAI Agents SDK installed: `pip install openai-agents`
+- A running DB MCP Server instance (SSE mode)
+
+### Basic Integration Example
+
+Here's how to integrate the DB MCP Server with an OpenAI Agent:
+
+```python
+from openai import OpenAI
+from agents.agent import Agent, ModelSettings
+from agents.tools.mcp_server import MCPServerSse, MCPServerSseParams
+
+# Connect to the MCP server
+db_server = MCPServerSse(
+    params=MCPServerSseParams(
+        url="http://localhost:9095/sse",  # URL to your running DB MCP server
+        schema={
+            "params": {
+                "type": "array", 
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "name": {"type": "string"},
+                        "description": {"type": "string"},
+                        "parameters": {"type": "object"}
+                    }
+                }
+            }
+        }
+    ),
+)
+
+# Create the agent with access to database tools
+agent = Agent(
+    name="Database Agent",
+    model="gpt-4o",
+    model_settings=ModelSettings(temperature=0.1),
+    instructions="""
+    You are a database helper agent. You can execute SQL queries,
+    manage database transactions, and explore schema information.
+    """,
+    mcp_servers=[db_server],
+)
+
+# Now the agent can be used to interact with your databases through the OpenAI API
+```
+
+### Testing Your Integration
+
+The repository includes a test script to verify compatibility with the OpenAI Agents SDK:
+
+```bash
+# Run the test script
+./test_tools/openai-agent-sdk-test/run_test.sh
+```
+
+The script will:
+1. Build the server with the latest changes
+2. Start the server if it's not already running
+3. Test the connection with the OpenAI Agents SDK
+4. Report if the integration is working correctly
+
+### Troubleshooting Agents SDK Integration
+
+If you encounter issues:
+
+1. Ensure the server is running in SSE mode on the expected port
+2. Check that your OpenAI API key is set as an environment variable
+3. Verify that your agent's instructions mention the database tools specifically
+4. Inspect the server logs for any error messages

go.mod

@@ -5,7 +5,7 @@ go 1.23
 toolchain go1.24.1
 
 require (
-	github.com/FreePeak/cortex v1.0.4
+	github.com/FreePeak/cortex v1.0.5
 	github.com/go-sql-driver/mysql v1.9.1
 	github.com/joho/godotenv v1.5.1
 	github.com/lib/pq v1.10.9

go.sum

@@ -1,7 +1,7 @@
 filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA=
 filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
-github.com/FreePeak/cortex v1.0.4 h1:iIEMrCM7tvB3PfEDO8pwfKK7dbw68tUZw3vj8MuENPU=
-github.com/FreePeak/cortex v1.0.4/go.mod h1:hGbco4oGy1f+YxWXd+LjxtFvNSF4+ns3qwK1I1MKG4k=
+github.com/FreePeak/cortex v1.0.5 h1:IlAgIo1F6M7rmDVadFFxIQXdRfKPm177DUMPMfUrfhE=
+github.com/FreePeak/cortex v1.0.5/go.mod h1:hGbco4oGy1f+YxWXd+LjxtFvNSF4+ns3qwK1I1MKG4k=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/go-sql-driver/mysql v1.9.1 h1:FrjNGn/BsJQjVRuSa8CBrM5BWA9BWoXXat3KrtSb/iI=

internal/delivery/mcp/tool_types.go

@@ -116,6 +116,7 @@ func (t *QueryTool) CreateTool(name string, dbID string) interface{} {
 		),
 		tools.WithArray("params",
 			tools.Description("Query parameters"),
+			tools.Items(map[string]interface{}{"type": "string"}),
 		),
 	)
 }
@@ -189,6 +190,7 @@ func (t *ExecuteTool) CreateTool(name string, dbID string) interface{} {
 		),
 		tools.WithArray("params",
 			tools.Description("Statement parameters"),
+			tools.Items(map[string]interface{}{"type": "string"}),
 		),
 	)
 }
@@ -256,6 +258,7 @@ func (t *TransactionTool) CreateTool(name string, dbID string) interface{} {
 		),
 		tools.WithArray("params",
 			tools.Description("Statement parameters"),
+			tools.Items(map[string]interface{}{"type": "string"}),
 		),
 		tools.WithBoolean("readOnly",
 			tools.Description("Whether the transaction is read-only (for begin)"),

server-linux.REMOVED.git-id

@@ -1 +1 @@
-a5e9fc730eb0a294a47a0247cbd31b3f83488570
+859b08668c2e014b51a2485ed668fde4f1f38c54

server.REMOVED.git-id

@@ -1 +1 @@
-be62f163a1c5fa071646e1ffef739de32bb6d597
+f30913d1682b4277f6e3e9609cf83657fae228b8