Freedcamp MCP 服务器

这是 Freedcamp 任务管理的模型上下文协议 (MCP) 服务器实现。它提供了在 Freedcamp 项目中创建、更新和删除任务的工具。

特征

• 创建具有标题、描述、优先级、截止日期和受让人的新任务

• 更新现有任务，包括状态变化

• 删除任务

• 凭证的环境变量支持

• 错误处理和验证

Related MCP server: Basecamp MCP Server

先决条件

• Node.js 17 或更高版本

• TypeScript

• 具有 API 访问权限的 Freedcamp 帐户

• 来自 Freedcamp 的 API 密钥和秘密

• 来自 Freedcamp 的项目 ID

安装（仅用于手动调用，不需要与 IDE 或其他 MCP 桌面客户端一起使用）

1. 克隆存储库：

git clone <repository-url>
cd freedcamp-mcp

2. 安装依赖项：

npm install

3. 使用您的 Freedcamp 凭据在根目录中创建一个.env文件：

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

用法

运行服务器

首先构建 TypeScript 代码：

npm run build

然后启动服务器：

npm start

运行测试工具

该项目包括一个全面的测试工具，可验证所有 MCP 功能：

npm test

测试工具执行以下检查：

1. 使用适当的协议版本进行服务器初始化

2. 工具清单和能力验证

3. 使用各种参数创建任务

4. 任务更新，包括状态变化

5. 任务列表和验证

可用工具

1. freedcamp_add_task

   • 在 Freedcamp 中创建新任务

   • 参数：

     • title （必填）：任务标题

     • description （可选）：任务描述

     • priority （可选）：任务优先级（0-3）

     • due_date （可选）：任务截止日期（YYYY-MM-DD）

     • assigned_to_id （可选）：分配任务的用户 ID

2. freedcamp_update_task

   • 更新现有任务

   • 参数：

     • task_id （必需）：要更新的任务的ID

     • title （可选）：新任务标题

     • description （可选）：新任务描述

     • priority （可选）：新任务优先级（0-3）

     • due_date （可选）：新的到期日（YYYY-MM-DD）

     • assigned_to_id （可选）：分配任务的新用户 ID

     • status （可选）：新任务状态（0=打开，1=完成，2=关闭）

3. freedcamp_list_tasks

   • 列出已配置的 Freedcamp 项目中的所有任务

   • 无需参数（使用环境变量中的项目 ID）

   • 返回任务及其详细信息的列表

IDE 集成

可以使用npx直接运行服务器，而无需克隆存储库。

光标

1. 在项目根目录中打开（或创建） .cursor/mcp.json 。

2. 添加您的 Freedcamp MCP 服务器配置：

   {
     "mcpServers": {
       "freedcamp": {
         "command": "npx",
         "args": ["freedcamp-mcp"],
         "env": {
           "FREEDCAMP_API_KEY": "your_api_key",
           "FREEDCAMP_API_SECRET": "your_api_secret",
           "FREEDCAMP_PROJECT_ID": "your_project_id"
         }
       }
     }
   }

3. 重新启动 Cursor 或重新加载 MCP 服务器。

袋鼠

1. 打开（或创建）您的 Roo MCP 配置文件（通常是roo.mcp.json或类似的）。

2. 添加您的 Freedcamp MCP 服务器配置：

   {
     "mcpServers": {
       "Freedcamp": {
         "transport": "stdio",
         "command": "npx",
         "args": ["freedcamp-mcp"],
         "env": {
           "FREEDCAMP_API_KEY": "your_api_key",
           "FREEDCAMP_API_SECRET": "your_api_secret",
           "FREEDCAMP_PROJECT_ID": "your_project_id"
         }
       }
     }
   }