使用说明

项目简介

Trello MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供与 Trello 任务管理工具集成的能力。通过此服务器，LLM 可以读取和操作 Trello 的看板、列表和卡片，从而实现智能化的任务管理和协作。

主要功能点

看板操作:
- 读取所有看板或特定看板的详细信息。
列表操作:
- 读取指定看板中的所有列表或特定列表的详细信息。
- 创建新的列表。
- 更新列表名称。
- 归档（删除）列表。
卡片操作:
- 读取指定列表中的所有卡片或特定卡片的详细信息。
- 创建新的卡片。
- 更新卡片的各种属性（如描述、名称等）。
- 删除卡片。
Prompt 帮助:
- 提供可用的 Trello 操作的帮助信息，指导用户如何与服务器交互。

安装步骤

环境准备:
- 确保已安装 Python 3.12 或更高版本。推荐使用 'uv' 包管理器进行管理。
- 安装 Claude for Desktop 应用程序，并确保已登录您的 Claude 账户并启动 Claude 应用 (此步骤可能为可选，取决于您的 MCP 客户端类型，但根据仓库 README 建议需要)。
- 拥有 Trello 账户和 API 凭据。
- 确保已安装 uv 包管理器。
获取 Trello API 凭据:
- 访问 Trello Apps Administration。
- 创建一个新的集成应用 (New Power-Up or Integration)。
- 填写应用信息（"Iframe connector URL" 可以留空），并选择正确的工作区。
- 点击您的应用图标，从左侧边栏导航到 "API key"。
- 复制 "API key"，然后在右侧找到 "you can manually generate a Token." 点击 "token" 链接生成 Trello Token 并复制。

配置环境变量:

复制仓库中的 '.env.example' 文件，并重命名为 '.env'。

打开 '.env' 文件，填入您刚刚获取的 Trello API Key 和 Token：

TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here

安装 'uv' (如果尚未安装):

curl -LsSf https://astral.sh/uv/install.sh | sh

并确保 'uv' 已添加到您的 PATH 环境变量中。

克隆仓库并安装依赖:

git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
uv run mcp install main.py

重启 MCP 客户端:
- 如果您使用 Claude Desktop app，请重启 Claude 应用使 MCP 服务器生效。

服务器配置

对于 MCP 客户端，您需要配置连接到 Trello MCP Server 的信息。以下是推荐的配置 (JSON 格式)：

{
  "serverName": "TrelloMCP",
  "command": "uv",
  "args": ["run", "mcp", "dev", "main.py"]
}

配置参数说明:

'serverName': MCP 服务器的名称，可以自定义，例如 "TrelloMCP"。
'command': 启动 MCP 服务器的命令，这里使用 'uv' 运行器。
'args': 传递给 'uv run' 命令的参数列表，'mcp dev main.py' 指示 'uv run mcp' 以开发模式运行 'main.py' 文件，启动 Trello MCP Server。

注意: 上述配置中的 'command' 和 'args' 需要根据您的实际环境和 MCP 客户端的要求进行调整。如果您在安装和运行过程中遇到问题，请参考仓库的 README 文件或检查错误日志。

基本使用方法

成功安装并配置 Trello MCP Server 后，您可以通过 MCP 客户端（如 Claude）以自然语言指令与 Trello 进行交互。以下是一些示例查询：

"Show me all my boards" (显示我的所有看板)
"What lists are in board [board_name]?" (看板 [board_name] 中有哪些列表？)
"Create a new card in list [list_name] with title [title]" (在列表 [list_name] 中创建一个标题为 [title] 的新卡片)
"Update the description of card [card_name]" (更新卡片 [card_name] 的描述)
"Archive the list [list_name]" (归档列表 [list_name])

请参考仓库的 README 文件和代码注释，了解更详细的功能和使用方法。

关键词