MCP Server from OpenAPI

基于 OpenAPI 的 MCP 服务

基于 OpenAPI 规范实现的 MCP 服务，同时支持 SSE（服务器发送事件）和流式响应。

前置条件

• Python 3.x
• pip（Python 包管理器）
• Anthropic API 密钥（用于 MCP 客户端）
• Google API 密钥（用于 ADK Agent）

安装

1. 创建并激活虚拟环境：

python3 -m venv venv
source venv/bin/activate

2. 安装依赖：

pip install -r requirements.txt

服务设置

服务可通过两种模式运行：

SSE 模式

python server/mcp_server_sse.py --spec server/httpbin_openapi.yaml --name httpbin --base-url https://httpbin.org

流式模式

python server/mcp_server_stream.py --spec server/httpbin_openapi.yaml --name httpbin --base-url https://httpbin.org

客户端设置

MCP 客户端

1. 在项目根目录中创建 .env 文件，并添加你的 Anthropic API 密钥：

ANTHROPIC_API_KEY=your_api_key_here

2. 运行你选择的客户端：
   • 对于 SSE 客户端：

   python client/sse_client.py
   

   • 对于流式客户端：

   python client/stream_client.py
   

使用 MCP 或流式客户端的示例：

MCP Client Started!
Type your queries or 'quit' to exit.

Query: Get Headers

I'll help you get the headers using the api_call function.
[Calling tool api_call with args {'kwargs': '{"action": "get_headers"}'}]
Here are the headers from the response:

```json
{
    "Accept": "*/*",
    "Accept-Encoding": "gzip, deflate",
    "Content-Type": "application/json",
    "Host": "httpbin.org",
    "User-Agent": "python-httpx/0.28.1",
    "X-Amzn-Trace-Id": "Root=1-683fecc4-674af7e9323b027c4b9bc740"
}

ADK Agent

前置条件

1. 安装 ADK：

pip install google-adk

设置步骤

1. 重要：流式模式的变通方案

   • 从 Google ADK 仓库下载最新的 mcp_session_manager.py
   • 替换 ADK 安装目录中的现有文件：

     # Typical path (adjust Python version as needed)
     cp mcp_session_manager.py venv/lib/python3.13/site-packages/google/adk/tools/mcp_tool/
     

2. 进入 Clients 目录：

cd client

3. 配置环境：

   • 在 httpb_sse_agent 和 httpbin_stream_agent 目录下的 .env 文件中添加以下内容：

   GOOGLE_GENAI_USE_VERTEXAI="False"
   GOOGLE_API_KEY="your_google_api_key_here"
   

4. 启动 ADK Web 界面：

adk web

功能

• 基于 OpenAPI 规范生成端点
• 支持 SSE 和流式响应
• 多种客户端实现（MCP 和 ADK）
• 通过环境变量轻松配置

故障排除

ADK 流式模式问题

如果 ADK Agent 在流式模式下遇到问题：

1. 确认已替换 mcp_session_manager.py 文件
2. 检查 .env 文件中是否正确设置了 Google API 密钥
3. 确保使用的是最新版本的 ADK

许可证

本项目采用 Apache 2.0 许可证。