Taiga项目协议服务器

Taiga MCP服务器

此MCP（模型上下文协议）服务器为AI助手提供了访问您的Taiga项目管理实例的权限。

特性

• 获取当前项目：从您的Taiga实例中检索第一个/当前项目
• 获取项目待办列表：获取特定项目的所有待办事项（用户故事）

安装

先决条件

• Python 3.8+
• Taiga实例正在运行

设置

cd /home/rebelloa/mcp-taiga
pip install -e .

或者具有开发依赖性：

pip install -e ".[dev]"

配置

服务器使用这些环境变量：

• TAIGA_HOST （默认值：https://taiga.example.com)-您的Taiga实例的URL
• TAIGA_USERNAME -身份验证用户名
• TAIGA_PASSWORD -身份验证密码
• TAIGA_TOKEN -身份验证令牌（如果提供，则代替用户名/密码使用）

使用Claude Desktop

将此添加到您的Claude Desktop配置文件中：

在MacOS上: ~/Library/Application Support/Claude/claude_desktop_config.json

在Windows上: %APPDATA%/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"taiga": {
			"command": "python3",
			"args": ["-m", "taiga_mcp_server"],
			"env": {
				"TAIGA_HOST": "https://taiga.example.com",
				"TAIGA_USERNAME": "your_username",
				"TAIGA_PASSWORD": "your_password"
			}
		}
	}
}

或者使用令牌：

{
	"mcpServers": {
		"taiga": {
			"command": "python3",
			"args": ["-m", "taiga_mcp_server"],
			"env": {
				"TAIGA_HOST": "https://taiga.example.com",
				"TAIGA_TOKEN": "your_auth_token"
			}
		}
	}
}

在VS代码中使用GitHub Copilot

将此添加到您的VS代码设置中(.vscode/settings.json 或用户设置）：

{
	"github.copilot.chat.mcp.servers": {
		"taiga": {
			"command": "python3",
			"args": ["-m", "taiga_mcp_server"],
			"env": {
				"TAIGA_HOST": "https://taiga.example.com",
				"TAIGA_USERNAME": "your_username",
				"TAIGA_PASSWORD": "your_password"
			}
		}
	}
}

可用工具

get_current项目

从您的Taiga实例中获取当前/第一个项目。无需参数。

退货：

• 项目ID
• 项目名称
• 项目别名
• 描述
• 创建日期
• 成员数量

get_project_backlog

获取特定项目的所有待办事项（用户故事）。

参数：

• project_id （必填）：项目的ID
• limit （可选，默认值：100）：要返回的最大项目数

每个积压项目的回报：

• 项目参考（例如#123）
• 主题/标题
• 描述
• 状态
• 分配给（如果已分配）
• 优先级

发展

直接运行服务器

TAIGA_HOST=https://taiga.example.com \
TAIGA_USERNAME=user \
TAIGA_PASSWORD=password \
python3 taiga_mcp_server.py

运行测试

python3 -m pytest

故障排除

连接问题

• 验证 TAIGA_HOST 正确且可访问
• 检查您的凭据（或令牌）是否有效
• 确保您的Taiga实例正在运行且可访问

身份验证错误

• 如果使用令牌身份验证，请确保令牌有效且未过期
• 如果使用用户名/密码，请验证两者是否正确
• 检查您的用户在Taiga中是否具有适当的权限

参考文献

• Python Taiga库
• 泰加API文件
• MCP规范