Task API Server - MCP TypeScript Implementation

基本能力

产品定位

milkosten_task-mcp-server 是一个任务管理 API 服务器，旨在为开发者和 AI 工具提供标准化的任务管理接口。

核心功能

• 任务管理操作：
• 列出任务（支持过滤）
• 创建新任务（支持自定义属性）
• 更新任务详情（描述、状态、类别、优先级）

• 删除任务

• 双接口模式：

• STDIO 协议支持（用于命令行和 AI 代理集成）

• HTTP+SSE 协议支持（用于浏览器和 HTTP 客户端访问）

• MCP 协议实现：

• 完整的 Model Context Protocol 实现
• 任务数据结构资源
• 任务操作工具

• 错误处理和信息提示

• 质量保证：

• 全面的测试客户端
• 测试完成后自动关闭服务器
• 详细的 API 响应验证

适用场景

• 开发者需要集成任务管理功能的应用程序
• AI 代理需要访问任务管理功能
• 浏览器应用需要任务管理接口

工具列表

• listTasks：列出所有任务，支持状态、类别和优先级过滤
• createTask：创建新任务，支持自定义描述、类别和优先级
• updateTask：更新任务详情，包括描述、状态、类别和优先级
• deleteTask：删除指定任务

常见问题解答

• 如何更改 HTTP 服务器端口？：通过设置 TASK_MANAGER_HTTP_PORT 环境变量或 PORT 环境变量（优先级更高）
• 如何连接到外部任务 API？：在 .env 文件中设置 TASK_MANAGER_API_BASE_URL 和 TASK_MANAGER_API_KEY

使用教程

使用依赖

• Node.js 16.x 或更高版本
• npm 或 pnpm 包管理器

安装教程

1. 克隆仓库： bash git clone https://github.com/yourusername/mcp-template-ts.git cd mcp-template-ts

2. 安装依赖： bash npm install 或使用 pnpm： bash pnpm install

3. 创建 .env 文件并配置任务 API 凭据： bash TASK_MANAGER_API_BASE_URL=https://your-task-api-url.com/api TASK_MANAGER_API_KEY=your_api_key_here TASK_MANAGER_HTTP_PORT=3000

4. 构建项目： bash npm run build

运行服务器

STDIO 模式（用于 CLI/AI 集成）

npm start

或

node dist/index.js

HTTP 模式（用于 Web 访问）

npm run start:http

或

node dist/http-server.js

调试方式

运行测试套件验证功能：

npm test

这将： 1. 构建项目 2. 启动服务器实例 3. 连接测试客户端到服务器 4. 运行所有任务操作 5. 验证正确响应 6. 自动关闭服务器

许可证

该项目遵循 MIT 开源许可条款。