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 提交代碼修改。