GitHub 代理式聊天 MCP 服务器

这是一个使用 Go 语言实现的 GitHub 代理式聊天 MCP（模型上下文协议）服务器。它提供了通过自然语言与 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）

贡献

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

许可证

MIT License