Trello终端管理工具

一个轻量级的MCP服务器,将Claude Code连接到Trello看板,通过终端管理卡片、跟踪任务和运行每日站会。

  • by applezebra
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 applezebra/trello-mcp

使用说明

Trello MCP服务器

一个轻量级的MCP服务器,用于连接 克劳德代码 您的Trello董事会。管理卡片、跟踪任务和运行每日站立——所有这些都可以在您的终端上完成。

所得

9个MCP工具 要完全控制Trello:

工具 它做什么
trello_list_boards 列出您的所有董事会
trello_get_lists 在板上获取列表(列)
trello_get_cards 在列表中获取卡片
trello_create_card 创建新卡
trello_update_card 更新卡属性/在列表之间移动
trello_archive_card 将卡片存档
trello_add_comment 在卡片上添加评论
trello_search 全面搜索卡片
trello_daily_review 到期卡和有效卡的跨板汇总

5个斜线命令 对于常见工作流:

命令 它的作用
/trello-board 董事会快照——所有列表和卡片一目了然
/trello-daily 每日站立——逾期、今天到期、本周到期
/trello-search 带有格式化结果的搜索卡
/trello-add 使用自然语言快速创建卡片
/trello-cleanup 查找并存档过期卡片

设置

1.获取Trello证书

  1. 首选https://trello.com/power-ups/admin然后单击 新 创建电源(或使用现有电源)
  2. 复制您的 API密钥 来自Power-Up的API密钥部分
  3. 在API键旁边,单击 代币 链接以生成令牌
  4. 授权应用程序并复制您的 代币

2.克隆和构建

git clone https://github.com/applezebra/trello-mcp.git
cd trello-mcp
npm install
npm run build

3.添加到克劳德代码

claude mcp add trello \
  -e TRELLO_API_KEY=your_api_key_here \
  -e TRELLO_TOKEN=your_token_here \
  -- node $(pwd)/dist/index.js

提示: 让克劳德帮你完成这一步。只需说: “帮助我设置此Trello MCP服务器” 它将阅读此README并引导您完成。

4.安装Slash命令

将命令文件复制到Claude Code命令目录:

mkdir -p ~/.claude/commands
cp .claude/commands/trello-*.md ~/.claude/commands/

5.验证

重新启动Claude Code(或启动新会话),然后尝试:

/trello-board

它应该列出你的Trello板。

使用示例

# See all your boards
> Ask Claude: "Show me my Trello boards"

# Daily standup
> /trello-daily

# View a specific board
> /trello-board My Project

# Quick add a card
> /trello-add Fix login bug to My Project > Backlog due:friday

# Search across all boards
> /trello-search API integration

# Clean up stale cards
> /trello-cleanup My Project days:14

安全

  • API密钥和令牌仅通过环境变量传递,从不存储在文件中
  • 所有Trello API调用都使用HTTPS
  • 只有两个生产依赖关系: @modelcontextprotocol/sdk 和 zod
  • API调用前通过Zod模式验证的所有输入
  • 错误消息中的凭据编辑

发展

npm install        # install dependencies
npm run build      # compile TypeScript
npm test           # run tests

项目结构

src/
  index.ts           # MCP server entry point
  trello-client.ts   # Trello REST API wrapper
  tools.ts           # Tool definitions with Zod schemas
  types.ts           # TypeScript interfaces
.claude/commands/    # Slash command definitions
tests/               # Unit + integration tests

许可证

麻省理工学院