敏捷照明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密钥的环境变量。