Jama Connect MCP Server logo

Jama Connect MCP Server

by t-j-thomas

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.

View on GitHub

Last updated: N/A

What is Jama Connect MCP Server?

The Jama Connect MCP Server is an unofficial, open-source Model Context Protocol (MCP) server designed to provide read-only access to a Jama Connect instance. It wraps the py-jama-rest-client library, enabling interactions with Jama data through MCP clients.

How to use Jama Connect MCP Server?

To use the server, clone the repository, install dependencies using uv sync, configure environment variables for Jama Connect authentication (either directly or via AWS Parameter Store), and then run the server using uv run python jama_mcp/server.py. Integrate with your MCP client by configuring it to launch the server with the appropriate command and environment variables.

Key features of Jama Connect MCP Server

  • Read-only access to Jama Connect data

  • MCP interface for integration with various clients

  • Authentication via environment variables or AWS Parameter Store

  • Local execution for enhanced security and control

  • Mock mode for testing without a live Jama instance

Use cases of Jama Connect MCP Server

  • Integrating Jama Connect data into other applications via MCP

  • Automating data extraction and reporting from Jama Connect

  • Developing custom tools and integrations for Jama Connect

  • Testing Jama Connect integrations in a controlled environment using mock mode

FAQ from Jama Connect MCP Server

What is MCP?

Model Context Protocol (MCP) is a protocol for exchanging data between different tools and applications.

How do I authenticate with Jama Connect?

You can authenticate either by providing the Jama URL, client ID, and client secret directly as environment variables, or by storing the client ID and secret in AWS Parameter Store and providing the path to the secret.

What is mock mode?

Mock mode allows you to run the server without connecting to a live Jama Connect instance, using predefined sample data for testing purposes. Set JAMA_MOCK_MODE to true to enable it.

Why is the server not published on PyPI?

To encourage users to inspect the code, understand its API interactions, and adapt it to their specific security requirements.

What do I do if I get a connection or authentication error?

Verify that your Jama URL, client ID, and client secret are correct. If using AWS Parameter Store, ensure the path is correct and the server has permissions to access the secret. Also, ensure that the secret is valid JSON.