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 文件。