模型上下文协议(MCP)示例
模型上下文协议(MCP)的参考实现,支持LLM和应用之间的无缝工具调用,提供客户端/服务器架构、HTTP API、本地CLI和AWS Bedrock集成。
快速入门
先决条件
- Python 3.10 或更高版本
- Poetry(推荐用于依赖管理)
安装步骤
- 克隆仓库: git clone https://github.com/yourusername/mcp-example.git cd mcp-example
- 使用 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}}'