Github Agentic Chat

🚀 GitHub 效能聊天 MCP 服务器

本项目是一个专为 GitHub 效能聊天打造的 Model Context Protocol (MCP) 服务器，采用 Go 语言编写。它提供了一系列工具，让用户能够通过自然语言与 GitHub 进行交互，同时还具备强大的向量搜索功能，极大地提升了使用体验。

🚀 快速开始

本服务器使用 Go 语言开发，为用户提供了与 GitHub 进行自然语言交互的工具，同时具备向量搜索功能。以下是使用前的准备和启动步骤。

✨ 主要特性

• GitHub 操作支持：支持搜索 GitHub 仓库和创建问题，方便用户在 GitHub 上进行高效操作。
• 向量搜索功能：可将文档添加到向量存储库，并在存储的文档中进行语义搜索，提升信息检索效率。
• 可扩展性：具备可扩展的结构，便于后续添加更多功能。

📦 安装指南

先决条件

• 安装 Go 1.21 或更高版本。
• 准备好安装了 pgvector 扩展的 PostgreSQL 数据库。
• 获取 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=你的_GitHub令牌_此处
export DATABASE_URL=postgres://用户名:密码@localhost:5432/数据库名
export OPENAI_API_KEY=你的_OpenAI_API密钥_此处

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": "/绝对路径/bin/github-agentic-chat-mcp"
        }
    }
}

6. 重启 Claude Desktop

💻 使用示例

可用工具

GitHub 工具

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

向量搜索工具

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

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

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

📄 许可证

本项目采用 MIT 许可证。

贡献

欢迎大家为项目贡献代码！请随意提交 Pull Request。