使用说明
MCP POC-完整设置指南
这是与GitHub集成的自定义MCP(模型上下文协议)服务器的概念验证(POC)。
🚀 快速开始
1.本地测试
在本地测试MCP服务器:
cd mcp-server
pip install -r requirements.txt
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | python3 server.py
预期产量:
{"jsonrpc": "2.0", "id": 1, "result": {"tools": [{"name": "reverse_text", "description": "Reverses a string", "input_schema": {...}}]}}
2.测试reverse_text工具
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"reverse_text","arguments":{"text":"hello"}}}' | python3 server.py
预期产量:
{"jsonrpc": "2.0", "id": 2, "result": {"text": "olleh"}}
3.设置GitHub页面注册表
- 创建新分支
gh-pages✅ 完成 - 推一下
registry/registry.json到那个分支✅ 完成 - 在存储库设置中启用GitHub Pages✅ 完成
- 访问注册表:
https://knackforge-inc.github.io/mcp-poc/registry/registry.json
4.在GitHub组织中注册
- 转到GitHub组织设置
- 导航至 代码与自动化→ MCP注册表URL
- 添加:
https://knackforge-inc.github.io/mcp-poc/registry/registry.json
5.运行GitHub操作工作流
手动触发工作流:
gh workflow run mcp-test.yml
📋 项目结构
mcp-poc/
├── registry/
│ └── registry.json # MCP registry configuration
├── mcp-server/
│ ├── server.py # Python MCP server implementation
│ └── requirements.txt # Python dependencies
├── workflows/
│ └── mcp-test.yml # GitHub Actions workflow
└── README.md # This file
✅ 成功标准
如果满足以下条件,则POC成功:
- ✅ GitHub在注册表中识别您的MCP服务器
- ✅
tools/list返回工具元数据 - ✅ 在GitHub Actions中运行MCP是有效的
- ✅ 可以通过HTTPS访问注册表
- ✅ Copilot可以调用您的工具(Beta功能)
