MCP Superthread Plus

MCP Superthread Plus服务器

社区维护的MCP服务器 超级线程，一个强大的项目管理平台。该服务器使AI助手能够通过自然对话管理卡片、电路板、文档等，非常适合使用AI简化项目设置、根据需求创建任务和工作空间自动化的团队。

目录

• MCP Superthread Plus服务器

- 目录 - 特性 - ⚠️ 重要提示：预发布软件 - 安装 - 获取API密钥 - 配置 - 选择性工具启用 - 智能卡定位 - 可用工具 - 用户和工作区管理 - 卡片管理 - 标签管理 - 项目管理（路线图） - 董事会管理 - Sprint管理 - 空间管理 - 页面管理 - 笔记管理 - 评论与协作 - 搜索 - 使用示例 - 初始设置-发现您的工作区 - 创建工作空间结构 - 根据需求创建任务 - 使用清单管理卡片 - 与评论协作 - 需求 - 发展 - 设置 - 命令 - 本地运行 - 建筑 - 贡献 - 许可证

特性

• 📋 卡片管理 -使用完整的工作流程控制（标签、清单、关系、任务）创建和管理卡片
• 📊 董事会和空间 -使用可定制的董事会和组织空间组织工作
• 🗺️ 路线图项目 -计划和跟踪大型项目（史诗）
• 📝 文档 -创建和维护页面
• 💬 协作 -在卡片和页面上讨论并发表评论
• 🔍 搜索 -在所有实体中查找任何内容
• 🎯 会议笔记 -管理会议记录和转录

⚠️ 重要提示：预发布软件

这是一项正在进行的工作。 使用前请仔细阅读：

• 临时解决方案： Superthread有一个 官方MCP服务器 他们正在积极开发。我们的目标是提供一个更完整的工具集，具有完全的读/写API访问权限，直到他们的官方服务器扩展。我们是 不 试图替换他们的官方服务器——我们相信他们正在构建它——我们现在只是想要更全面的功能。这是在此期间可以使用的东西。

• 未准备好生产： 此服务器尚未达到1.0版本，应谨慎使用。随着Superthread继续扩展其官方MCP服务器，它可能永远不会达到1.0版本。

• 非官方和独立： 这是一个社区项目，与Superthread没有正式联系或认可。

• API直接通过： 此服务器对超级线程API进行直接的API调用，并返回与接收到的数据完全相同的所有数据。我们不执行任何缓存、数据缩减或转换。这意味着响应可能很大，并可能影响性能。

• 使用风险自负： 虽然我们采取了合理的安全预防措施，但这是一个实验性的软件。在将其用于重要工作流程之前，在非关键环境中进行彻底测试。

• 有限支持： 这是一个在业余时间维护的社区项目。欢迎问题和拉取请求。

底线： 如果你需要稳定和生产就绪的东西，请等待Superthread的官方解决方案。如果您现在需要功能并了解风险，此服务器旨在帮助弥合差距。

安装

添加到您的MCP设置文件中（例如，Claude Desktop配置）：

{
  "mcpServers": {
    "superthread": {
      "command": "npx",
      "args": ["-y", "mcp-superthread-plus"],
      "env": {
        "SUPERTHREAD_API_KEY": "your-api-key-here"
      }
    }
  }
}

要求： Node.js 22+

获取API密钥

1. 登录Superthread→ 设置和首选项→ 账户→ API访问
2. 创建令牌
3. 添加到上面的MCP配置中

配置

所有配置都是通过环境变量完成的：

选择性工具启用

默认情况下， 所有工具域均已启用 当 SUPERTHREAD_ENABLED_TOOLS 未设置。这确保了向后兼容性和开箱即用的完整功能。

为了减少AI客户端中的工具混乱，您可以明确指定要启用哪些域。 只有您列出的域将被启用 -所有其他人都将被禁用。

仅启用卡和板：

{
  "mcpServers": {
    "superthread": {
      "command": "npx",
      "args": ["-y", "mcp-superthread-plus"],
      "env": {
        "SUPERTHREAD_API_KEY": "your-api-key-here",
        "SUPERTHREAD_ENABLED_TOOLS": "cards,boards"
      }
    }
  }
}

启用除注释和标签之外的大多数工具：

{
  "env": {
    "SUPERTHREAD_API_KEY": "your-api-key-here",
    "SUPERTHREAD_ENABLED_TOOLS": "users,cards,boards,projects,spaces,sprints,pages,comments,search"
  }
}

重要提示：

• 未设置或为空 =所有域均已启用（功能齐全）
• 设置为特定域 =仅启用这些域，禁用所有其他域
• 这是向后兼容的-没有此设置的现有配置将继续与启用的所有工具一起工作

智能卡定位

默认情况下，新创建或移动的卡将添加到列表底部。 虽然这对大多数列表（如“待办事项列表”或“待办事项”）都很有效，但它 对于“完成”或“已存档”这样的完成列表，你通常会遇到问题 想在顶部看到最近完成的项目。没有智能 定位，最近的完井被埋没在底部，使其更难 追踪刚刚完成的事情。

使用以下命令配置卡片应自动放置在顶部的列表 SUPERTHREAD_LISTS_ADD_TO_TOP:

{
  "env": {
    "SUPERTHREAD_API_KEY": "your-api-key-here",
    "SUPERTHREAD_LISTS_ADD_TO_TOP": "Done,Completed,Finished"
  }
}

特征：

• 通配符支持： 使用 * 用于模式匹配（例如。， "Done,Complet*,*finished,*archive*")
• 不区分大小写 同等匹配“完成”、“完成”和“完成”
• 逗号转义： 对带逗号的列表名称使用反斜杠（例如。， "Tasks\\, Urgent")
• LLM覆盖： 工具中的显式位置参数始终优先
• 优雅的回退： 如果板/冲刺获取失败，卡将使用默认定位

可用工具

用户和工作区管理

卡片管理

注： 所有卡片工具都使用数组参数的批处理操作。始终传递数组，即使是单个操作。

标签管理

注： 所有标记工具都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。

注： 标签管理工具使用通过浏览器网络检查发现的未记录的API端点。

项目管理（路线图）

注： 所有项目工具都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： project_get, project_create, project_update, project_delete, project_add_related, project_remove_related.

董事会管理

注： 所有板工具都使用数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： board_get, board_create, board_update, board_delete, board_create_list, board_update_list, board_delete_list.

Sprint管理

注： Sprint get操作使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： sprint_get.

空间管理

注： 所有空间工具都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： space_get, space_create, space_update, space_delete, space_add_member, space_remove_member.

页面管理

注： 所有页面操作都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： page_get, page_create, page_update, page_archive, page_delete.

笔记管理

注： 所有注释操作都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： note_get, note_create, note_delete.

评论与协作

注： 所有注释工具都使用带有数组参数的批处理操作。始终传递数组，即使是单个操作。可用的批处理工具： comment_get, comment_create, comment_update, comment_delete, comment_reply, comment_update_reply, comment_delete_reply.

注： 评论工具支持@提及和HTML格式。您可以要求AI在评论中按姓名提及团队成员，并使用HTML标签进行丰富的格式设置（标题、粗体、斜体、列表、链接等）。

搜索

使用示例

初始设置-发现您的工作区

User: Get my Superthread account info
AI: *calls user_get_my_account*
→ Your account: user@example.com
→ Workspaces available:
  - Main Team 
  - Side Project

创建工作空间结构

User: Set up a new project workspace
AI: I'll create the structure:
1. Creating space "Q1 2025 Launch"...
2. Creating boards: Development, Design, Marketing...
3. Adding lists: To Do, In Progress, Review, Done...
✓ Workspace ready! Space ID: space_789

根据需求创建任务

User: Create tasks for implementing user authentication
AI: *calls card_create with 5 cards in single batch operation*
✓ Created 5 tasks in one call:
- Set up auth provider (High priority, 8 points)
- Design login UI (Medium, 5 points)
- Implement JWT tokens (High, 8 points)
- Add password reset flow (Medium, 5 points)
- Write auth tests (Low, 3 points)

使用清单管理卡片

User: Add a checklist to card 123 for deployment steps, mark the first two as done
AI: *creates checklist, then adds 5 items with checked status in single batch call*
✓ Created deployment checklist with items:
  - [x] Run tests
  - [x] Update changelog
  - [ ] Build production bundle
  - [ ] Deploy to staging
  - [ ] Deploy to production

与评论协作

User: Comment on card 456 and mention Sarah Chen: "Can you review the API changes?"
AI: *creates comment with mention*
✓ Added comment with mention to @Sarah Chen

需求

• Node.js 22+
• 超级线程帐户 具有API访问权限
• 个人访问令牌 来自Superthread帐户设置

发展

设置

git clone https://github.com/steveclarke/mcp-superthread-plus.git
cd mcp-superthread-plus
pnpm install
pnpm run build

命令

# Watch mode for development
pnpm run dev

# Build
pnpm run build

# Test
pnpm run test

# Lint
pnpm run lint
pnpm run lint:fix

# Format
pnpm run format

本地运行

将MCP客户端配置为从本地开发目录运行：

{
  "mcpServers": {
    "superthread": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-superthread-plus/dist/index.js"],
      "env": {
        "SUPERTHREAD_API_KEY": "your-token"
      }
    }
  }
}

建筑

该服务器使用基于合成的API客户端体系结构，每个域（卡、板、项目等）都有资源类。客户端处理Superthread的现代UI术语和传统API术语之间的身份验证、错误处理和自动术语映射。

对于贡献者： 看 docs/contributing/ARCHITECTURE.md 了解详细的建筑信息和 docs/contributing/API-REFERENCE.md 用于API术语映射。

重要提示： 看 docs/NOTES.md 获取有关API异常、限制和未记录端点的信息。

贡献

欢迎投稿！我们专注于全面的API覆盖范围和完整的读/写功能。

贡献领域：

• 增强的响应过滤和格式化
• 性能优化
• 文档改进

许可证

麻省理工学院