MCP 服务器集成指南

先决条件

  • 安装 Node.js（版本 14 或更高版本）
  • npm 包管理器
  • 具有所需依赖项的Python环境

设置步骤

  1. 安装MCP服务器包

    1
    npm install -g @modelcontextprotocol/server-github

  2. 启动MCP服务器

    1
    npx @modelcontextprotocol/server-github

    服务器应启动并显示连接 URL。

  3. 验证连接

    • 在 Chainlit 界面中查找插头图标 (🔌)
    • 插头图标旁边应出现数字 (1)，表示连接成功
    • 控制台应显示：“GitHub 插件设置成功完成”（以及其他状态行）

故障排除

常见问题

  1. 端口冲突

    1
    Error: listen EADDRINUSE: address already in use

    解决方案：使用以下命令更改端口：

    1
    npx @modelcontextprotocol/server-github --port 3001

  2. 身份验证问题

    • 确保 GitHub 凭据配置正确
    • 检查 .env 文件包含所需的令牌
    • 验证 GitHub API 访问

  3. 连接失败

    • 确认服务器正在预期端口上运行
    • 检查防火墙设置
    • 验证Python环境是否有所需的包

连接验证

在以下情况下，您的 MCP 服务器已正确连接：
1.控制台显示“GitHub插件安装成功完成”
2. 连接日志显示“✓ MCP 连接状态：活动”
3. GitHub命令在聊天界面工作

环境变量

.env 文件中需要：

1
2
GITHUB_TOKEN=your_github_token
MCP_SERVER_PORT=3000  # Optional, default is 3000

测试连接

在聊天中发送此测试消息：

1
Show me the repositories for username: [GitHub Username]

成功的响应将显示存储库信息。