该项目提供了一个模式背景协议(MCP)服务器,它暴露了与Jama Connect实例互动的只读工具. 它充当了官方Jama Softwarepy-jama-rest-client图书馆的MCP包装器.

** 免责声明:** 这是一个第三方,开源项目,没有正式附属于或认可贾马软件公司.

** 说明:** 此服务器目前只支持只读操作 。 未来更新中可能会添加写操作.

□哲学:地方执行和安全

此 MCP 服务器是 ** 有意不发布 ** 作为 PyPI 或其他索引上的软件包. 这项决定鼓励用户:

1. ** Clone/Fork 仓库:** 直接获取代码。 2.** 检查《守则》:** 准确了解服务器在运行前的工作,特别是关于API的相互作用和证书处理。
2. ** 符合需要:** 修改特定企业要求或安全态势的代码.

这种方法优先考虑安全意识和用户对方便的控制,减轻与安装可能未经核实的第三方包有关的风险.

Jama Connect MCP Server (Unofficial)

This project provides a Model Context Protocol (MCP) server that exposes read-only tools for interacting with a Jama Connect instance. It acts as an MCP wrapper around the official Jama Software py-jama-rest-client library.

Disclaimer: This is a third-party, open-source project and is not officially affiliated with or endorsed by Jama Software.

Note: This server currently only supports read-only operations. Write operations may be added in future updates.

Philosophy: Local Execution & Security

This MCP server is intentionally not published as a package on PyPI or other indices. This decision encourages users to:

1. Clone/Fork the Repository: Obtain the code directly.
2. Inspect the Code: Understand exactly what the server does before running it, especially concerning API interactions and credential handling.
3. Adapt as Needed: Modify the code for specific enterprise requirements or security postures.

This approach prioritizes security awareness and user control over convenience, mitigating risks associated with installing potentially unverified third-party packages. Local execution by cloning the repository is the only supported method at this time.

Prerequisites

Building From Source

• Python: Version 3.12 or higher.
• uv: The Python package installer and virtual environment manager. (Installation Guide)
• Git: For cloning the repository.
• Docker For running with docker

Setup

Docker

1. Clone the Repository:

   git clone https://github.com/t-j-thomas/jama-mcp-server.git
   cd jama-mcp-server
   

2. Docker Build:

   sudo docker build -t jama-mcp-server .
   

   This will build the docker image using the project’s pyproject.tonl & uv.lock configrations

3. For Build issues due to Certificates for the Jama Rest Client Repo:

   If you see an error like certificate verification failed: CAFile, you can optionally clone the https://github.com/jamasoftware-ps/py-jama-rest-client.git repo into this directory, and uncomment

   # py-jama-rest-client = { path = "./py-jama-rest-client", editable = true }

   from pyproject.toml file and comment out

   py-jama-rest-client = { git = "https://github.com/jamasoftware-ps/py-jama-rest-client.git" }.

   Then,

   uv sync
   sudo docker build -t jama-mcp-server .
   

Building From Source

1. Clone the Repository:

   git clone https://github.com/t-j-thomas/jama-mcp-server.git
   cd jama-mcp-server
   

2. Install Dependencies: Navigate into the server directory and use uv to create a virtual environment and install dependencies.

   uv sync