AI导哈

项目数据连接服务

Agile Luminary MCP Server是一个连接AI客户端与Agile Luminary项目管理系统的协议服务器，提供项目文档检索、工作任务获取和历史工作查询功能。

  • by AgileLuminary
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 AgileLuminary/mcp-agile-luminary

使用说明

敏捷照明MCP服务器

这是一个模型上下文协议（MCP）服务器，将AI客户端（如Cursor或Claude Desktop）连接到托管在 https://agileluminary.com.

什么是MCP？

模型上下文协议（MCP）是人工智能应用程序连接到外部数据源和服务的标准化方式。该服务器充当您的人工智能客户端和敏捷灯具REST API之间的桥梁，允许您在人工智能对话中直接检索项目详细信息、工作分配和文档。

建筑

AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)

特性

此MCP服务器提供了三个主要工具，用于从Agile Luminary API获取数据：

📚 获取相关文档

  • 目的：根据搜索字符串检索相关文档
  • 参数: searchString （必填）-在文档中搜索的文本
  • 用例：查找与您当前工作相关的文档和规范

📋 getCurrentWork

  • 目的：获取当前分配给用户的工作
  • 参数：无
  • 用例：查看主动分配给您的任务和用户故事

🔍 getPastWork

  • 目的：根据搜索条件检索与用户故事相关的已完成工作
  • 参数: searchString （必填）-查找相关过去工作的搜索词
  • 用例：回顾历史背景和已完成的任务，以便更好地做出决策

安装和设置

先决条件

  • Node.js（v16或更高版本）
  • 支持MCP的AI客户端（Cursor IDE、Claude Desktop等）

再进行

npm install @modelcontextprotocol/sdk zod

环境变量

将API密钥设置为环境变量：

export LUMINARY_API_KEY=your_api_key_here

运行服务器

node server.js

服务器将启动并通过stdio传输监听来自AI客户端的连接。

配置

用于游标IDE

将此添加到MCP配置中：

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

适用于克劳德桌面

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "agile-luminary": {
      "command": "node",
      "args": ["path/to/your/server.js"],
      "env": {
        "LUMINARY_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用示例

连接后，您可以在AI客户端中使用自然语言：

  • “搜索有关身份验证的文档”
  • “显示我当前的工作分配”
  • “查找与用户登录功能相关的以往工作”
  • “关于支付系统有什么文件？”
  • “根据我目前的工作，以前完成过哪些类似的任务？”

API终点

服务器连接到以下Agile Luminary API端点：

  • POST http://localhost:5006/bend/mcp/documents/search -搜索文档
  • GET http://localhost:5006/bend/mcp/userstories/current -获取当前工作
  • POST http://localhost:5006/bend/mcp/userstories/search -搜索过去的工作

益处

  • 实时数据：始终从部署的系统中获取最新的项目信息
  • 情境感知AI：您的人工智能助手可以了解您的项目状态和文档的全部内容
  • 无缝集成：直接在您的开发环境中工作
  • 安全：服务器本地处理身份验证和API通信
  • 搜索功能：通过智能搜索查找相关文档和过去的工作

认证

服务器使用 LUMINARY_API_KEY 用于身份验证的环境变量。此密钥传递到 Authorization 所有API请求的头。请确保在运行服务器之前设置此环境变量。

错误处理

该服务器包括全面的错误处理功能，用于：

  • 网络连接问题
  • API身份验证失败
  • 响应格式错误
  • 服务不可用
  • 缺少API密钥

贡献

此MCP服务器专为与Agile Luminary项目管理系统配合使用而设计。对于修改或增强，请确保与现有API端点兼容。

备注：确保您的敏捷灯具帐户已创建，并且您拥有来自的API密钥 https://agileluminary.com 在使用此MCP服务器之前。设置 LUMINARY_API_KEY API密钥的环境变量。

相关 MCP