AI导哈

项目管理协议服务器

Worksection MCP Server是一个基于模型上下文协议（MCP）的服务，允许AI助手通过自然语言与Worksection项目管理平台交互，管理项目、任务、评论、成员和标签。

  • by novgorodskii
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 novgorodskii/worksection-mcp-server

使用说明

MCP服务器工作区

MCP（模型上下文协议）服务器 工作区 --乌克兰和东欧流行的项目管理平台。

让像Claude这样的人工智能助手通过自然语言与您的Worksection帐户进行交互：管理项目、任务、评论、成员和标签。

目录

快速开始

# 1. Install
git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install && npm run build

# 2. Configure env vars
export WORKSECTION_URL=https://yourcompany.worksection.com
export WORKSECTION_API_KEY=your_api_key_here

# 3. Run
node dist/index.js

在工作区获取API密钥： 账户→ API → 显示API密钥 （只有帐户所有者有权访问）。

安装

先决条件

  • Node.js 18或更高版本
  • 具有管理员权限的工作分区帐户

来源

git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install
npm run build

环境变量

在shell中设置这些或创建 .env 文件（参见 .env.example):

变量 描述
WORKSECTION_URL 您的工作区URL（例如。 https://yourcompany.worksection.com)
WORKSECTION_API_KEY 工作区设置中的Admin API密钥

配置

克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "worksection": {
      "command": "node",
      "args": ["/path/to/worksection-mcp-server/dist/index.js"],
      "env": {
        "WORKSECTION_URL": "https://yourcompany.worksection.com",
        "WORKSECTION_API_KEY": "your_api_key_here"
      }
    }
  }
}

克劳德代码

claude mcp add worksection -- node /path/to/worksection-mcp-server/dist/index.js

确保 WORKSECTION_URL 和 WORKSECTION_API_KEY 在shell环境中设置。

直接执行

WORKSECTION_URL=https://yourcompany.worksection.com \
WORKSECTION_API_KEY=your_key \
node dist/index.js

可用工具

服务器暴露 21工具 横跨5个类别。

📁 Projects (7 tools)
工具 说明
worksection_get_projects 列出所有具有可选状态筛选器的项目
worksection_get_project 获取详细的项目信息
worksection_create_project 创建新项目
worksection_update_project 更新项目详细信息
worksection_archive_project 归档项目
worksection_activate_project 激活已存档的项目
worksection_get_project_folders 列出项目文件夹
✅ Tasks (8 tools)
工具 说明
worksection_get_all_tasks 列出项目中的所有任务
worksection_get_tasks 列出特定项目中的任务
worksection_get_task 获取详细的任务信息
worksection_create_task 创建任务（或子任务）
worksection_update_task 更新任务详细信息
worksection_complete_task 将任务标记为已完成
worksection_reopen_task 重新打开已完成的任务
worksection_search_tasks 按文本、受让人、日期等搜索任务。
💬 Comments (2 tools)
工具 说明
worksection_get_comments 获取任务的所有评论
worksection_post_comment 对任务发表评论
👥 Members (2 tools)
工具 说明
worksection_get_members 列出所有帐户成员
worksection_add_project_members 向项目添加成员
🏷️ Tags (2 tools)
工具 说明
worksection_get_tags 列出可用标签
worksection_set_task_tags 在任务上设置标签

认证

此服务器使用 管理员令牌 身份验证方法：

  • 根据查询参数+API密钥生成MD5哈希
  • 提供对所有帐户数据的完全访问权限
  • 只有帐户所有者才能生成API密钥

有关每个用户的访问权限，请参阅 工作部分OAuth 2.0文档.

速率限制

工作部门强制执行 每秒1个请求 速率限制。此服务器会自动处理它——请求以最小1.1s的间隔排队，因此您不必担心达到限制。

安全

  • 🔐 API密钥仅从环境变量中读取-从不进行硬编码
  • ✅ 所有输入均已Zod模式验证
  • 🖥️ 通过stdio传输在本地运行——无网络暴露
  • 🛡️ API工作区本身不允许删除项目、任务、注释或成员（设计安全）

发展

npm run dev    # Watch mode (auto-recompile)
npm run build  # One-time build
npm start      # Run the server

项目结构

worksection-mcp-server/
├── src/
│   ├── index.ts              # Server entry point
│   ├── types.ts              # TypeScript type definitions
│   ├── constants.ts          # Shared constants
│   ├── services/
│   │   ├── client.ts         # Worksection API client (auth + rate limit)
│   │   └── formatters.ts     # Markdown formatting helpers
│   └── tools/
│       ├── projects.ts       # Project management tools
│       ├── tasks.ts          # Task management tools
│       ├── comments.ts       # Comment tools
│       ├── members.ts        # Member/team tools
│       └── tags.ts           # Tag/label tools
├── package.json
├── tsconfig.json
└── README.md

许可证

麻省理工学院

Made with ❤️ for the Worksection community

相关 MCP