模型上下文协议服务器

一个与GitHub集成的自定义模型上下文协议(MCP)服务器,用于管理和调用工具。

  • by KnackForge-Inc
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 KnackForge-Inc/mcp-poc

使用说明

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组织中注册

  1. 转到GitHub组织设置
  2. 导航至 代码与自动化→ MCP注册表URL
  3. 添加: 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成功:

  1. ✅ GitHub在注册表中识别您的MCP服务器
  2. ✅ tools/list 返回工具元数据
  3. ✅ 在GitHub Actions中运行MCP是有效的
  4. ✅ 可以通过HTTPS访问注册表
  5. ✅ Copilot可以调用您的工具(Beta功能)

📚 参考文献