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
   

   This installs required dependencies, including boto3 if you plan to use AWS Parameter Store for credentials.

Configuration

The server requires environment variables to connect to your Jama Connect instance using OAuth 2.0. Credentials can be provided directly or fetched securely from AWS Parameter Store.

Authentication Methods:

1. Direct Environment Variables:

   • JAMA_URL (Required): The base URL of your Jama Connect instance (e.g., https://yourcompany.jamacloud.com).
   • JAMA_CLIENT_ID (Required for this method): Your Jama API OAuth Client ID.
   • JAMA_CLIENT_SECRET (Required for this method): Your Jama API OAuth Client Secret.
   • If both JAMA_CLIENT_ID and JAMA_CLIENT_SECRET are set, they will be used directly, and the AWS Parameter Store configuration will be ignored.

2. AWS Parameter Store (Not Supported for Docker):

   • This method is used only if JAMA_CLIENT_ID and JAMA_CLIENT_SECRET are not both set directly in the environment.
   • JAMA_URL (Required): The base URL of your Jama Connect instance.

... View full README on GitHub