Jama Connect MCP Server (Unofficial)
2025.04.16
0
PythonJama ConnectMCP开发工具开发效率
Jama Connect MCP Server 是一个非官方的开源项目，提供基于 Model Context Protocol (MCP) 的服务，用于与 Jama Connect 实例进行只读交互。该项目围绕 Jama Software 的官方 `py-jama-rest-client` 库构建，旨在通过 MCP 协议提供对 Jama Connect 数据的访问。
**核心功能**：
- 提供只读工具，用于查询 Jama Connect 实例中的项目、项目和关系等数据。
- 支持通过 OAuth 2.0 进行认证，包括直接环境变量和 AWS Parameter Store 两种方式。
- 提供 Mock 模式，用于测试和开发，无需连接实际的 Jama Connect 实例。
**适用场景**：
- 开发人员需要与 Jama Connect 进行集成，但希望避免直接使用 REST API。
- 团队需要在本地环境中快速测试和调试 Jama Connect 数据访问逻辑。
- 需要安全地管理 Jama Connect 认证信息，例如通过 AWS Parameter Store。
View on GitHub
Overview
基本能力
产品定位
Jama Connect MCP Server 是一个用于与 Jama Connect 实例进行只读交互的 MCP 服务，适用于开发人员和团队集成 Jama Connect 数据。
核心功能
- 提供只读工具，如
get_jama_projects、get_jama_item、get_jama_relationships等。 - 支持 OAuth 2.0 认证，包括直接环境变量和 AWS Parameter Store 两种方式。
- 提供 Mock 模式，用于测试和开发。
适用场景
- 开发人员集成 Jama Connect 数据。
- 本地测试和调试 Jama Connect 数据访问逻辑。
- 安全地管理认证信息。
工具列表
get_jama_projects: 获取 Jama Connect 中的项目列表。get_jama_item: 获取特定项目或项的详细信息。get_jama_relationships: 获取项目或项之间的关系。
常见问题解答
- Connection/Authentication Errors: 检查
JAMA_URL、JAMA_CLIENT_ID和JAMA_CLIENT_SECRET是否正确设置，或 AWS Parameter Store 配置是否正确。 - Tool Errors: 检查传递给工具的参数是否正确。
- Mock Mode Not Working: 确保
JAMA_MOCK_MODE环境变量设置为true。
使用教程
使用依赖
- Python: 版本 3.12 或更高。
- uv: Python 包安装器和虚拟环境管理器。
- Git: 用于克隆仓库。
安装教程
- 克隆仓库：
bash git clone https://github.com/t-j-thomas/jama-mcp-server.git cd jama-mcp-server - 安装依赖：
bash uv sync
调试方式
- 运行服务器：
bash uv run python jama_mcp/server.py - 使用测试客户端：
bash uv run python test_mcp_client.py