Github Agentic Chat MCP

🚀 GitHub 代理式聊天 MCP 服务器

这是一个用 Go 语言实现的 GitHub 代理式聊天 MCP（模型上下文协议）服务器。它为用户提供了通过自然语言与 GitHub 交互的工具，还集成了向量搜索功能，极大地提升了与 GitHub 交互的便捷性和效率。

✨ 主要特性

• GitHub 操作功能：支持搜索 GitHub 仓库，还能在指定仓库中创建问题，方便用户快速定位资源和反馈问题。
• 向量搜索功能：
  • 可将文档添加到向量存储，便于后续进行语义搜索。
  • 能在存储的文档中进行语义搜索，精准定位所需信息。
• 可扩展性：具备可扩展的结构，方便后续添加更多功能，以满足不断变化的需求。

📦 安装指南

先决条件

• Go 1.21 或更高版本
• PostgreSQL 数据库（需安装 pgvector 扩展）
• GitHub 个人访问令牌
• OpenAI API 密钥
• Claude Desktop 或其他 MCP 兼容客户端

安装步骤

1. 克隆仓库：

git clone https://github.com/akhidasTech/github-agentic-chat-mcp.git
cd github-agentic-chat-mcp

2. 设置环境变量：

export GITHUB_TOKEN=your_github_token_here
export DATABASE_URL=postgres://user:password@localhost:5432/dbname
export OPENAI_API_KEY=your_openai_api_key_here

3. 配置 PostgreSQL 数据库，安装 pgvector 扩展：

CREATE EXTENSION vector;

4. 构建服务器：

go build -o bin/github-agentic-chat-mcp

5. 配置 Claude Desktop： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件，添加如下内容：

{
    "mcpServers": {
        "github-chat": {
            "command": "/absolute/path/to/bin/github-agentic-chat-mcp"
        }
    }
}

6. 重启 Claude Desktop 客户端

💻 使用示例

可用工具

GitHub 工具

• search_repositories：使用查询字符串搜索 GitHub 仓库。
• create_issue：在指定的 GitHub 仓库中创建新问题。

向量搜索工具

• add_to_vector_store：将文档添加到向量存储中，支持语义搜索。
  • 参数：
    • content: 要存储的文本内容
    • metadata: 包含内容元数据的 JSON 字符串
  • 示例：

{
    "content": "这是一个关于 GitHub Actions 的文档",
    "metadata": "{\"type\": \"documentation\", \"tags\": [\"github\", \"ci-cd\"]}"
}

• vector_search：在存储的文档中执行语义搜索。
  • 参数：
    • query: 搜索查询文本
    • limit: 返回结果的最大数量（默认为 5）

📄 许可证

本项目采用 MIT License。

贡献

欢迎提交贡献！请随意通过 Pull Request 提交代码修改。