Teamwork MCP Server

Teamwork.com与大型语言模型集成的Model Context Protocol服务器

📌 您是否是Teamwork.com用户，并希望现在将AI工具（如Claude Desktop、VS Code Copilot Chat、Gemini等）连接到您的Teamwork.com站点？请直接跳转至**使用指南（如何连接）**以获取令牌、启用MCP及客户端配置示例。

📖 概览

此MCP（Model Context Protocol）服务器实现了大型语言模型与Teamwork.com之间的无缝集成。它提供了一个标准化接口，使LLM能够与Teamwork.com项目进行交互，允许AI代理执行各种项目管理操作。

🤖 什么是MCP？

Model Context Protocol（MCP）是一种开放协议，用于标准化应用程序向LLM提供上下文的方式。此服务器描述了Teamwork.com中所有可用的操作（工具），这些操作以LLM可以理解并通过AI代理执行的形式呈现。

✨ 特性

• 多种传输模式：HTTP和STDIO接口适用于不同的部署场景
• 安全认证：与Teamwork.com集成的Bearer Token和OAuth2认证
• 工具框架：可扩展的工具集架构，用于添加新功能
• 生产就绪：全面的日志记录、监控和可观测性
• 只读模式：可选的只读操作限制，确保安全性

🚀 可用服务器

本项目提供了三种与Teamwork.com MCP服务器交互的方式：

📡 HTTP服务器

适用于云部署和多客户端支持的生产就绪HTTP服务器。

📖 完整的HTTP服务器文档

快速开始：

TW_MCP_SERVER_ADDRESS=:8080 go run cmd/mcp-http/main.go

💬 STDIO服务器

适用于桌面应用和开发环境的直接STDIO接口。

📖 完整的STDIO服务器文档

快速开始：

TW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go

🛠️ HTTP CLI

用于测试和调试MCP服务器功能的命令行工具。

📖 完整的HTTP CLI文档

快速开始：

go run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools

📋 先决条件

• Go 1.25或更高版本
• 有效的Teamwork.com API凭证（Bearer Token或OAuth2设置）

🧪 开发与测试

运行测试

# 运行所有测试
go test ./...

# 运行特定包的测试
go test ./internal/twprojects/

MCP Inspector

为了调试目的，请使用MCP Inspector工具：

NODE_EXTRA_CA_CERTS=letsencrypt-stg-root-x1.pem npx @modelcontextprotocol/inspector node build/index.js

[!IMPORTANT] 注意：当使用Let's Encrypt证书颁发机构的OAuth2认证时，需要设置NODE_EXTRA_CA_CERTS环境变量。请从这里下载证书。

🏗️ 架构

├── cmd/
│   ├── mcp-http/          # HTTP服务器实现
│   ├── mcp-stdio/         # STDIO服务器实现
│   └── mcp-http-cli/      # 通过HTTP测试的CLI工具
├── internal/
│   ├── auth/              # 认证辅助程序（Bearer Token和OAuth2处理）
│   ├── config/            # 配置管理（环境变量、标志）
│   ├── helpers/           # 共享实用函数（错误处理、链接辅助、工具解析）
│   ├── request/           # HTTP请求原语 / Teamwork API连接
│   ├── toolsets/          # 工具框架和注册逻辑
│   └── twprojects/        # Teamwork项目/领域工具（任务、标签、计时器等）
├── examples/              # 使用和集成示例（LangChain Node/Python）
├── usage.md               # 最终用户设置和连接指南
├── Makefile               # 常见开发者任务
├── Dockerfile             # 容器构建配置
├── CODE_OF_CONDUCT.md     # 社区准则
├── CONTRIBUTING.md        # 贡献指南
└── SECURITY.md            # 安全策略