Adk Generator MCP Server

ADK代理代码生成器MCP

在本地运行OpenSearch

docker run -it -p 9200:9200 -p 9600:9600 -e OPENSEARCH_INITIAL_ADMIN_PASSWORD=STRONG_PASSWORD -e "discovery.type=single-node"  --name opensearch-node opensearchproject/opensearch:latest

运行MCP服务器

uv sync

uv pip install -e .

python scripts/seed_opensearch.py

start-server

#or

python -m adk_mcp_server

额外部门

source /Users/dhruvilpatel/Documents/adk-generator-mcp-server/.venv/bin/activate && pip install --force-reinstall numpy==1.26.4

添加MCP服务器

"adkmcpserver": {
    "command": "python",
    "args": [
        "-m",
        "/../Documents/adk-generator-mcp-server"
    ]
}

使用Roo代码扩展进行配置

1. 安装Roo Code扩展：

- 打开VS代码。 - 转到“扩展”视图(Ctrl+Shift+X 或 Cmd+Shift+X). - 搜索“Roo Code”并安装扩展。

1. 配置MCP服务器：

- 打开Roo Code设置(Ctrl+Shift+P 或 Cmd+Shift+P 然后键入“房间代码：打开设置”）。 - 找到 mcp_settings.json 文件。 - 在中为ADK MCP服务器添加新条目 servers 部分。使用相对路径而不是绝对路径。 - 配置应该如下所示：

"adkmcpserver_stdio": {
    "command": "python",
    "args": [
        "-m",
        "adk_mcp_server"
    ]
},
"adkmcpserver_sse": {
    "command": "python",
    "args": [
        "-m",
        "adk_mcp_server"
    ],
    "stream": true
}

1. 设置环境变量：

- 确保你有一个 .env 项目目录根目录中的文件。 - 添加 GEMINI_API_KEY 和 OPENSEARCH_PASSWORD 到 .env 文件。

GEMINI_API_KEY=YOUR_GEMINI_API_KEY
OPENSEARCH_PASSWORD=YOUR_OPENSEARCH_PASSWORD

1. 安装依赖项：

- 跑 uv sync 以创建虚拟环境。 - 跑 uv pip install -e . 安装项目依赖项。

1. 种子开放搜索：

- 跑 python scripts/seed_opensearch.py 为OpenSearch索引添加数据种子。

1. 运行MCP服务器：

- 跑 python -m adk_mcp_server 启动服务器。

使用MCP检查员进行测试

1. 安装MCP检查器工具：

- 如果你还没有，请使用npm全局安装MCP Inspector工具：

npm install -g @modelcontextprotocol/inspector

1. 运行MCP检查器工具：

- 使用MCP服务器的URL运行MCP检查器工具：

mcp-inspector --url http://localhost:8000/mcp

*   Replace `http://localhost:8000/mcp` with the actual URL of your MCP server.

1. 与MCP检查器工具交互：

- MCP检查器工具将提供一个web界面，您可以使用该界面与MCP服务器进行交互。 - 您可以使用该工具向MCP服务器发送请求并检查响应。

故障排除：Roo Code MCP服务器配置无法识别Python或服务器文件位置

如果Roo Code无法找到Python可执行文件或服务器文件，您可能需要在MCP服务器配置中指定这些文件的完整路径。

1. 指定Python可执行文件的完整路径：

- 替换 "python" 使用Python可执行文件的完整路径（例如。， "/usr/bin/python3" 或 "/Users/your_username/.venv/bin/python").

1. 指定服务器文件的完整路径：

- 替换 "adk_mcp_server" 与完整的路径 adk_mcp_server 模块。要查找模块路径，可以运行 python -m adk_mcp_server 看看回溯。它将向您展示通往 __main__.py 文件，您应该使用包含该文件的目录。（例如。， "/Users/your_username/Documents/adk-generator-mcp-server/adk_mcp_server").

1. 具有完整路径的示例配置：

"adkmcpserver": {
    "command": "/usr/bin/python3",
    "args": [
        "-m",
        "adk_mcp_server"
    ],
    "cwd": "/Users/your_username/Documents/adk-generator-mcp-server"
}```