模型上下文协议(MCP)示例

模型上下文协议(MCP)示例

模型上下文协议(MCP)的参考实现,支持LLM和应用之间的无缝工具调用,提供客户端/服务器架构、HTTP API、本地CLI和AWS Bedrock集成。

快速入门

先决条件

  • Python 3.10 或更高版本
  • Poetry(推荐用于依赖管理)

安装步骤

  1. 克隆仓库: git clone https://github.com/yourusername/mcp-example.git cd mcp-example
  2. 使用 Poetry 安装依赖(推荐): poetry install 或使用 venv: python3 -m venv venv source venv/bin/activate # Windows 使用 venv\Scripts\activate pip install -e .

运行 CLI

使用以下命令启动本地工具交互界面: poetry run python -m mcp_example.adapters.stdio.cli 或使用 venv: python -m mcp_example.adapters.stdio.cli

启动服务器

运行 FastAPI 服务器: poetry run python -m mcp_example.server.main --host 0.0.0.0 --port 8000 或使用 venv: python -m mcp_example.server.main --host 0.0.0.0 --port 8000 访问 API 文档:http://127.0.0.1:8000/docs

测试服务器

列出可用函数: curl -X GET http://localhost:8000/api/functions -H "X-API-Key: test-key" 调用计算器函数: curl -X POST http://localhost:8000/api/functions/call -H "X-API-Key: test-key" -H "Content-Type: application/json" -d '{"name": "calculator", "parameters": {"operation": "add", "a": 5, "b": 3}}'