teambition-local MCP

teambition-local MCP

Wraps Teambition Open Platform v3 API as MCP tools for batch task creation, enabling n8n workflows to search projects, manage members, and create tasks.

Category
Visit Server

README

teambition-local MCP

将 Teambition 开放平台 v3 API 封装为 MCP 服务(Streamable HTTP),供 n8n 批量建任务工作流调用,也可复用给 Claude 等其他 MCP 客户端。

工具清单

工具 类型 用途
tb_search_projects 只读 按名称分页搜索项目,解析 projectId
tb_get_project 只读 按 ID 查项目详情
tb_list_project_members 只读 分页拉项目成员,用于负责人匹配
tb_search_tasks 只读 项目内按关键词分页搜任务,查重/找父任务
tb_get_task 只读 按 ID 查任务,校验目标父任务
tb_create_task 写 创建任务(仅确认阶段调用),返回真实 taskId 和链接

优先级映射:普通→0,紧急→1,非常紧急→2。任务备注经 note 字段完整传入。

部署(Docker)

  1. 复制 .env.example 为 .env,填入四个值。Secret 只存在这里,不要提交仓库、不要贴到聊天工具。
  2. docker build -t teambition-local-mcp . && docker run -d --name tb-mcp --env-file .env -p 3300:3300 teambition-local-mcp
  3. 健康检查:curl http://<主机>:3300/healthz → {"ok":true}
  4. 验证工具列表:
    curl -X POST http://<主机>:3300/mcp \
  -H "Authorization: Bearer <MCP_AUTH_TOKEN>" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
  5. 真实连通性验证(第一次务必做):用 tools/call 调 tb_search_projects,name 填一个已知项目名。若报权限错误,去开放平台「权限管理」勾选:项目查看、项目成员查看、任务列表查看(tb-core:task:list)、任务创建(tb-core:task:create),并在「应用发布」发布版本、安装到企业。

与 n8n 对接

  • n8n 侧使用 MCP Client 节点,Endpoint 填 http://<主机>:3300/mcp,传输选 Streamable HTTP,认证用 Header:Authorization: Bearer <MCP_AUTH_TOKEN>(存入 n8n Credentials,勿写死在节点里)。
  • n8n 与本服务同机或同内网部署时,不要把 3300 端口暴露到公网;必须公网时加 HTTPS 反代。

两处可能需要微调的端点

创建任务(/v3/task/create)、项目内任务查询(/v3/project/{id}/task/query)已对照官方文档核实。项目搜索(/v3/project/query)与项目成员(/v3/project/{id}/member/query)的路径和参数名请以你企业开放平台文档实测为准——如果第 5 步验证时报 404,在 server.mjs 顶部对应工具处改一行路径即可,工具名和入参结构不用动。

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured