](https://smithery.ai/server/@jessebautista/mcp-openproject-smithery)
OpenProject的MCP服务器(Smithery版)
该项目为OpenProject提供了一个模型上下文协议(MCP)服务器,专为部署和使用而设计 史密瑟里它公开了一组用于与自托管OpenProject实例交互的工具,并且与Smithery的HTTP传输和工具列表要求兼容。
关于此MCP服务器
- 使用TypeScript和Node.js构建 @模型上下文协议/类型脚本sdk.
- 公开用于项目和任务(工作包)的OpenProject CRUD工具。
- 设计用于轻松部署到Smithery,具有Docker支持和最小的生产就绪结构。
- 使用MCP Inspector和Smithery工具支持本地开发和测试。
已实施OpenProject工具
- 项目:
- openproject-create-project:创建新项目。 - openproject-get-project:按ID检索特定项目。 - openproject-list-projects:列出所有项目(支持分页)。 - openproject-update-project:更新现有项目的详细信息。 - openproject-delete-project:删除项目。
- 任务(工作包):
- openproject-create-task:在项目中创建新任务。 - openproject-get-task:按ID检索特定任务。 - openproject-list-tasks:列出任务,可选择按项目ID筛选(支持分页)。 - openproject-update-task:更新现有任务(需要 lockVersion). - openproject-delete-task:删除任务。
先决条件
- Node.js(建议使用v18或更高版本)
- npm
- 可通过URL访问的OpenProject实例
- 一个OpenProject API密钥
- (可选)Docker用于容器化构建
HTTP入口点与本地开发
此MCP服务器现在使用Express和官方的MCP Streamable HTTP传输。服务器可在以下位置访问 http://localhost:8000/mcp 运行后 npm run dev 或 npm start.
入口点代码(参见 src/index.ts):
import express from "express";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
const app = express();
app.use(express.json());
const mcpServer = setupMCPServer();
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
mcpServer.connect(transport);
app.all("/mcp", (req, res) => {
transport.handleRequest(req, res, req.body);
});
app.get("/", (_req, res) => res.send("MCP OpenProject server is running!"));
const PORT = process.env.PORT || 8000;
app.listen(PORT, () => {
console.log(`MCP server running on port ${PORT}`);
});- 这
/mcpendpoint是Smithery和MCP客户端的主要MCP HTTP端点。 - 根
/端点是健康检查。
本地运行
- 安装依赖项:
npm install- 构建项目:
npm run build- 启动服务器(开发模式):
npm run dev
# or for production
npm start- 访问MCP端点 http://localhost:8000/mcp
Docker使用
像以前一样构建和运行:
docker build -t mcp-openproject-smithery .
docker run --rm -p 8000:8000 --env-file .env mcp-openproject-smitherySmithery部署
该项目已为Smithery做好准备。这 /mcp 端点与Smithery的HTTP传输要求兼容。
在此处查看您的Smithery实时服务器: ](https://smithery.ai/server/@jessebautista/mcp-openproject-smithery)
MCP检查员进行本地测试
您可以使用以下工具在本地测试MCP服务器 MCP检查员:
npx @modelcontextprotocol/inspector npx mcp-remote@next http://localhost:8000/mcp打开检查器URL(通常 http://localhost:6274)在浏览器中与工具进行交互。
项目结构
src/index.ts--主MCP服务器逻辑smithery.yaml--Smithery服务器配置Dockerfile--生产就绪的Docker构建tsconfig.json--TypeScript配置package.json--项目依赖关系和脚本
许可证
麻省理工学院
______________________________________________________________________
此项目是为与Smithery和模型上下文协议一起使用而维护的。有关更多信息,请参阅:
