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。