使用说明
服务器MCP
此存储库包含多个 MCP服务器 在PokeChatbot主机项目中使用。
它包括:
- 普通服务器(远程/HTTP) → 提供简单的工具(回声、随机口袋妖怪)。
- GitHub MCP服务器 → 访问GitHub存储库元数据、问题、拉取请求和文件。
- 文件系统MCP服务器 → 提供对本地项目文件的访问。
📦 先决条件
- python 3.10+
pip install -r requirements.txt- A工作 虚拟环境 (
.venv) - 互联网接入(适用于GitHub MCP和远程服务器)
🚀 运行主机
启动主机CLI,它将连接到所有已配置的MCP服务器:
python -m src.host.cli
预期产量:
🚀 Poke VGC — MCP Host
============================================================
✓ Connected to PokeChatbot VGC (local)
✓ Connected to VGC HTTP Remote (remote)
✓ Connected to GitHub MCP Server
✓ Connected to Filesystem MCP Server
🔧 可用的MCP服务器
1. 普通远程服务器(HTTP)
这是部署到云端的MCP服务器。它提供了简单的演示工具。
工具:
echo→ 返回相同的文本random_pokemon→ 返回一个随机的口袋妖怪(可选择按类型筛选)
示例查询:
Trainer: Echo hello world
Trainer: Give me a random water-type Pokémon
2. GitHub MCP服务器
提供对GitHub仓库的访问。需要环境变量:
export GITHUB_TOKEN=your_personal_access_token
工具:
github_repo_infogithub_list_issuesgithub_get_filegithub_search_issuesgithub_pr_statusgithub_compare
示例查询:
Trainer: Get info about repo openai/openai-python
Trainer: List issues from my-repo
Trainer: Show file README.md from my-repo
3. 文件系统MCP服务器
提供对工作区下本地项目文件的访问。
工具:
files_listfiles_read
示例查询:
Trainer: List files in /server
Trainer: Read server/main.py
🧪 测试工具
主机运行后,您可以直接尝试:
Trainer: Give me a Trick Room team
Trainer: Echo "Testing remote echo"
Trainer: List files in data/restricted
Trainer: Get info about repo octocat/Hello-World
Trainer: Give me a random Fire Pokémon
✅ 总结
PokeVGC Team Builder→ 用于VGC团队生成的本地MCP服务器Trivial HTTP Server→ 部署到云端的远程服务器(简单工具)GitHub MCP Server→ GitHub元数据和仓库访问Filesystem MCP Server→ 本地文件资源管理器
所有这些都可以通过 主机CLI 与:
python -m src.host.cli