使用说明
场馆可视化MCP服务器
一个最小的模型上下文协议(MCP)服务器,它公开了一个将Trello卡添加到指定列表的工具。在stdio上运行,以便与MCP兼容的客户端一起使用。
特性
- 添加trello任务:创建一张新的Trello卡,其中包含可选的描述、到期/开始日期和标签。
需求
- Node.js 18+
- Trello凭据和目标列表ID
环境变量
在运行之前设置这些:
TRELLO_API_KEY:您的Trello API密钥TRELLO_TOKEN:您的Trello API代币TRELLO_LIST_ID:用于接收新卡的Trello列表ID
安装和构建
pnpm install
pnpm build
运行(本地)
export TRELLO_API_KEY=...
export TRELLO_TOKEN=...
export TRELLO_LIST_ID=...
node build/index.js
或者,在构建后,如果链接/安装了垃圾箱,您可以直接运行垃圾箱:
venue-visualiser-mcp-server
MCP客户端配置(示例)
与Claude Desktop配合使用效果最佳:
在macOS(克劳德桌面)上,编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加:
{
"mcpServers": {
"trello": {
"command": "node",
"args": [
"/Users/hashim/Documents/MyProjects/venue-visualiser-mcp-server/build/index.js"
],
"env": {
"TRELLO_API_KEY": "key",
"TRELLO_TOKEN": "token",
"TRELLO_LIST_ID": "id"
}
}
}
}
在Windows(克劳德桌面)上,编辑 %AppData%/Claude/claude_desktop_config.json.
PowerShell(在VS代码中打开):
code $env:AppData\Claude\claude_desktop_config.json
Windows上的JSON条目示例:
{
"mcpServers": {
"trello": {
"command": "node",
"args": ["C:\\path\\to\\venue-visualiser-mcp-server\\build\\index.js"],
"env": {
"TRELLO_API_KEY": "key",
"TRELLO_TOKEN": "token",
"TRELLO_LIST_ID": "id"
}
}
}
}
工具参考
- 名字:
add-trello-tasks - 描述:将新卡添加到特定板上的指定列表中
- 参数:
name(字符串,必填):卡片标题description(字符串,可选):卡片描述dueDate(字符串,可选):ISO 8601日期时间start(字符串,可选):YYYY-MM-DDlabels(string[],可选):Trello标签ID
如果缺少凭据,则返回Trello API响应(JSON)或错误描述。
发展
- 来源:
src/index.ts - 构建输出:
build/ - 脚本:
pnpm build
其他示例和注释:请参见 examples.md 和 zod.md.
许可证
国际协调委员会