MCP Agileday

🚀 Agileday MCP 服務器

Agileday MCP 服務器是一個用於 Agileday 的模型上下文協議（MCP）服務器，它能將 Agileday 的能力和員工數據與大語言模型（如 Claude Desktop 或 Cursor）相連接。藉助該服務器，你可以用自然語言詢問有關組織技能的問題、查找專家並探索能力概況。

🚀 快速開始

方法一：使用 Docker 與 Claude Desktop 運行

將以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "agileday": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "AGILEDAY_TENANT_ID=your_tenant_id",
        "-e", "AGILEDAY_API_TOKEN=your_api_token",
        "ghcr.io/eficode/mcp-agileday:latest"
      ]
    }
  }
}

方法二：使用 Docker 運行

1. 克隆倉庫：

git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
cd agileday-mcp-server

2. 構建鏡像：

docker build -t agileday-mcp-server .

3. 配置 Claude Desktop： 將以下內容添加到你的 claude_desktop_config.json 文件中（在 macOS 上通常位於 ~/Library/Application Support/Claude/，在 Windows 上位於 %APPDATA%\Claude\）。

{
  "mcpServers": {
    "agileday": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "AGILEDAY_TENANT_ID=your_tenant_id",
        "-e", "AGILEDAY_API_TOKEN=your_api_token",
        "agileday-mcp-server"
      ]
    }
  }
}

4. 重啟 Claude Desktop。

方法三：本地 Python 運行

1. 克隆倉庫並安裝依賴：

git clone [https://github.com/yourusername/agileday-mcp-server.git](https://github.com/yourusername/agileday-mcp-server.git)
cd agileday-mcp-server
pip install -r requirements.txt

2. 配置 Claude Desktop： 更新你的 claude_desktop_config.json 文件，使其指向 Python 腳本：

{
  "mcpServers": {
    "agileday": {
      "command": "python3",
      "args": ["/absolute/path/to/agileday_server.py"],
      "env": {
        "AGILEDAY_TENANT_ID": "your_tenant_id",
        "AGILEDAY_API_TOKEN": "your_api_token"
      }
    }
  }
}

方法四：作為服務運行

若要將其部署為獨立服務（例如用於遠程訪問或支持 HTTP 傳輸的客戶端），可使用 HTTP 傳輸模式。

docker run -d \
  -p 8000:8000 \
  -e AGILEDAY_TENANT_ID=your_tenant \
  -e AGILEDAY_API_TOKEN=your_token \
  ghcr.io/eficode/mcp-agileday:latest \
  --transport http

服務器將在以下地址可用：

• 通用端點：http://localhost:8000/mcp（支持 SSE 流和 POST 消息）
• 健康檢查：http://localhost:8000/health

✨ 主要特性

該服務器實現了以下工具：

• find_experts_with_skill
  • 查詢示例："Who knows React?"
  • 操作：搜索具備特定技能的員工，並返回他們的熟練程度。
• get_employee_competence_profile
  • 查詢示例："What are Jane Doe's top skills?"
  • 操作：檢索特定員工的完整技能列表、熟練程度和工作動力。
• list_organization_skills
  • 查詢示例："What skills do we have in the organization?"
  • 操作：檢索你的 Agileday 工作區中可用的完整技能分類法，按類別分組。這有助於 AI 準確瞭解要搜索的術語，避免猜測。

📦 安裝指南

運行服務器需要以下環境變量：

💻 使用示例

連接成功後，你可以向 Claude 詢問以下問題：

• "Who are the experts in Python at our company?"
• "Find me someone who knows Service Design and has a high proficiency."
• "What is Jane Doe's competence profile?"
• "Do we have enough people with Kubernetes skills?"

⚠️ 重要提示

• API 令牌：切勿將你的 AGILEDAY_API_TOKEN 提交到版本控制系統。始終通過環境變量或本地配置文件傳遞它。
• 只讀訪問：如果可能，建議使用具有隻讀權限的 API 令牌，因為此工具僅用於獲取數據。

🤝 貢獻指南

歡迎貢獻代碼！請隨時提交拉取請求。

1. 分叉倉庫。
2. 創建你的功能分支 (git checkout -b feature/AmazingFeature)。
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到該分支 (git push origin feature/AmazingFeature)。
5. 打開拉取請求。

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。