Pre-release

This release is a pre-release and may not be stable for production use.

CodeMie Assistants MCP Server

Python server implementing Model Context Protocol (MCP) for CodeMie Assistants operations.

Features

Chat with AI/Run CodeMie assistant

Note: The server requires authentication credentials via environment variables.

API

Tools

chat

Chat with a specific AI assistant Inputs:

message (string): Message to send to assistant
conversation_id (string): Identifier of current conversation. It should be always passed if present in current communication thread.
history (array, optional): Previous conversation messages in format: [{"role": "user|assistant", "message": "text"}]

Returns generated assistant response as text

Breaking changes in 0.2.0

The Python package is now codemie_mcp_assistants. The command codemie-mcp-assistants is unchanged.
The server no longer has built-in server addresses. CODEMIE_AUTH_SERVER_URL, CODEMIE_AUTH_REALM_NAME and CODEMIE_API_DOMAIN are required. Without them the server exits with an error.

Installation

Ensure you have Python 3.12 or later installed.

Important: Before running the MCP server, you must configure the required environment variables (see Environment Variables section below).

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run codemie-mcp-assistants.

uvx codemie-mcp-assistants

Using Poetry

Alternatively you can install via Poetry:

poetry install codemie-mcp-assistants

After installation, you can run it as a script using:

poetry run codemie-mcp-assistants

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

Required variables:

"mcpServers": {
  "codemie": {
    "command": "uvx",
    "args": ["codemie-mcp-assistants"],
    "env": {
      "CODEMIE_AUTH_SERVER_URL": "https://auth.example.com/auth",
      "CODEMIE_AUTH_REALM_NAME": "your-realm",
      "CODEMIE_API_DOMAIN": "https://codemie.example.com/code-assistant-api",
      "CODEMIE_ASSISTANT_ID": "your-assistant-id",
      "CODEMIE_USERNAME": "your-username",
      "CODEMIE_PASSWORD": "your-password"
    }
  }
}

Optional variables:

"env": {
  "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
  "CODEMIE_VERIFY_SSL": "true"
}

Using poetry installation

Required variables:

"mcpServers": {
  "codemie": {
    "command": "poetry",
    "args": ["run", "codemie-mcp-assistants"],
    "env": {
      "CODEMIE_AUTH_SERVER_URL": "https://auth.example.com/auth",
      "CODEMIE_AUTH_REALM_NAME": "your-realm",
      "CODEMIE_API_DOMAIN": "https://codemie.example.com/code-assistant-api",
      "CODEMIE_ASSISTANT_ID": "your-assistant-id",
      "CODEMIE_USERNAME": "your-username",
      "CODEMIE_PASSWORD": "your-password"
    }
  }
}

Optional variables:

"env": {
  "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
  "CODEMIE_VERIFY_SSL": "true"
}

Environment Variables

Mandatory Variables

The following environment variables must be configured before running the MCP server:

Platform settings (all three are required, an empty value counts as missing):

CODEMIE_AUTH_SERVER_URL: URL of your authentication server, for example https://auth.example.com/auth
CODEMIE_AUTH_REALM_NAME: authentication realm name
CODEMIE_API_DOMAIN: URL of your CodeMie API, for example https://codemie.example.com/code-assistant-api

The server has no built-in addresses. If any of the three is missing it prints Missing required settings: <names> and exits with a non-zero code, before any network call.

Assistant Configuration:

CODEMIE_ASSISTANT_ID: Your CodeMie assistant ID (required)

Authentication (choose one method):

Option 1: Username/Password

CODEMIE_USERNAME: Your CodeMie username
CODEMIE_PASSWORD: Your CodeMie password

Option 2: Client Credentials

CODEMIE_AUTH_CLIENT_SECRET: Auth client secret

Optional Variables

CODEMIE_AUTH_CLIENT_ID: authentication client ID (default: codemie-sdk)
CODEMIE_VERIFY_SSL: TLS certificate verification flag (default: true). Set false only for local testing.

Build

Make build:

make build

Metadata

Release files for codemie-mcp-assistants 0.2.0rc0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codemie-mcp-assistants 0.2.0rc0
File	Size	Uploaded
codemie_mcp_assistants-0.2.0rc0.tar.gz	6.1 kB	Oct 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for codemie-mcp-assistants 0.2.0rc0
File	Interpreter	ABI	Platform	Reset
codemie_mcp_assistants-0.2.0rc0-py3-none-any.whl 7.6 kB Oct 15, 2026	Python 3	none	any	Details

Total release size: 13.7 kB

Release files / codemie_mcp_assistants-0.2.0rc0.tar.gz

Download URL	codemie_mcp_assistants-0.2.0rc0.tar.gz
Size	6.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`9047bcb8185e4046e5863ee566b85e60a40a4a06d3375d6e93f99fe5a4d2a147`
BLAKE2b-256 checksum How to use checksums	`e6cb8df4f46a6e7c2bc9d9e12a24b4c03c0955db21bbd0f9b9ad97df6690c72d`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / codemie_mcp_assistants-0.2.0rc0-py3-none-any.whl

Download URL	codemie_mcp_assistants-0.2.0rc0-py3-none-any.whl
Size	7.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1f45b199e280d9d852123920567a1a4b52597a2ea17dc62ce4fabe2d038ed4d0`
BLAKE2b-256 checksum How to use checksums	`855524767480a4e4c78088d4567677bb78cd2b9df2951d5df12d151ec90751b7`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`