使用说明
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代码扩展进行配置
- 安装Roo Code扩展:
- 打开VS代码。
- 转到“扩展”视图(
Ctrl+Shift+X或Cmd+Shift+X). - 搜索“Roo Code”并安装扩展。
- 配置MCP服务器:
- 打开Roo Code设置(
Ctrl+Shift+P或Cmd+Shift+P然后键入“房间代码:打开设置”)。 - 找到
mcp_settings.json文件。 - 在中为ADK MCP服务器添加新条目
servers部分。使用相对路径而不是绝对路径。 - 配置应该如下所示:
- 打开Roo Code设置(
"adkmcpserver_stdio": {
"command": "python",
"args": [
"-m",
"adk_mcp_server"
]
},
"adkmcpserver_sse": {
"command": "python",
"args": [
"-m",
"adk_mcp_server"
],
"stream": true
}
- 设置环境变量:
- 确保你有一个
.env项目目录根目录中的文件。 - 添加
GEMINI_API_KEY和OPENSEARCH_PASSWORD到.env文件。
- 确保你有一个
GEMINI_API_KEY=YOUR_GEMINI_API_KEY
OPENSEARCH_PASSWORD=YOUR_OPENSEARCH_PASSWORD
- 安装依赖项:
- 跑
uv sync以创建虚拟环境。 - 跑
uv pip install -e .安装项目依赖项。
- 跑
- 种子开放搜索:
- 跑
python scripts/seed_opensearch.py为OpenSearch索引添加数据种子。
- 跑
- 运行MCP服务器:
- 跑
python -m adk_mcp_server启动服务器。
- 跑
使用MCP检查员进行测试
- 安装MCP检查器工具:
- 如果你还没有,请使用npm全局安装MCP Inspector工具:
npm install -g @modelcontextprotocol/inspector
- 运行MCP检查器工具:
- 使用MCP服务器的URL运行MCP检查器工具:
mcp-inspector --url http://localhost:8000/mcp
* Replace `http://localhost:8000/mcp` with the actual URL of your MCP server.
- 与MCP检查器工具交互:
- MCP检查器工具将提供一个web界面,您可以使用该界面与MCP服务器进行交互。
- 您可以使用该工具向MCP服务器发送请求并检查响应。
故障排除:Roo Code MCP服务器配置无法识别Python或服务器文件位置
如果Roo Code无法找到Python可执行文件或服务器文件,您可能需要在MCP服务器配置中指定这些文件的完整路径。
-
指定Python可执行文件的完整路径:
- 替换
"python"使用Python可执行文件的完整路径(例如。,"/usr/bin/python3"或"/Users/your_username/.venv/bin/python").
- 替换
-
指定服务器文件的完整路径:
- 替换
"adk_mcp_server"与完整的路径adk_mcp_server模块。要查找模块路径,可以运行python -m adk_mcp_server看看回溯。它将向您展示通往__main__.py文件,您应该使用包含该文件的目录。(例如。,"/Users/your_username/Documents/adk-generator-mcp-server/adk_mcp_server").
- 替换
-
具有完整路径的示例配置:
"adkmcpserver": {
"command": "/usr/bin/python3",
"args": [
"-m",
"adk_mcp_server"
],
"cwd": "/Users/your_username/Documents/adk-generator-mcp-server"
}```
