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