Skip to main content

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

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).

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_ASSISTANT_ID": "your-assistant-id",
      "CODEMIE_USERNAME": "your-username",
      "CODEMIE_PASSWORD": "your-password"
    }
  }
}

Optional variables (with defaults):

"env": {
  "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
  "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
  "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
  "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
}
Using poetry installation

Required variables:

"mcpServers": {
  "codemie": {
    "command": "poetry",
    "args": ["run", "codemie-mcp-assistants"],
    "env": {
      "CODEMIE_ASSISTANT_ID": "your-assistant-id",
      "CODEMIE_USERNAME": "your-username",
      "CODEMIE_PASSWORD": "your-password"
    }
  }
}

Optional variables (with defaults):

"env": {
  "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
  "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
  "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
  "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
}

Environment Variables

Mandatory Variables

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

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 (Environment-Specific)

By default, the server connects to the production environment with these settings:

  • CODEMIE_API_DOMAIN: https://codemie.lab.epam.com/code-assistant-api
  • CODEMIE_AUTH_CLIENT_ID: codemie-sdk
  • CODEMIE_AUTH_SERVER_URL: https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth
  • CODEMIE_AUTH_REALM_NAME: codemie-prod

You can override these variables to point to a different environment.

Example: Preview Environment Configuration

CODEMIE_API_DOMAIN="https://codemie-preview.lab.epam.com/code-assistant-api"
CODEMIE_AUTH_CLIENT_ID="codemie-preview-sdk"
CODEMIE_AUTH_SERVER_URL="https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth"
CODEMIE_AUTH_REALM_NAME="codemie-prod"

Other Optional Variables:

  • CODEMIE_VERIFY_SSL: SSL verification flag (default: true)

Build

Make build:

make build

Metadata

Release files for codemie-mcp-assistants 0.1.679

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.1.679
File Size Uploaded
codemie_mcp_assistants-0.1.679.tar.gz 5.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for codemie-mcp-assistants 0.1.679
File Interpreter ABI Platform
codemie_mcp_assistants-0.1.679-py3-none-any.whl Python 3 none any Details

Total release size: 12.6 kB

Release files / codemie_mcp_assistants-0.1.679.tar.gz

Download URL codemie_mcp_assistants-0.1.679.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
d458e4c1cbbfd9c0fc0dc87f56aa706420ddc71e4ce6d06f4f09c30384b9e913
BLAKE2b-256 checksum
How to use checksums
0c466b0947c96b77c23adb39d6ef4c3a610a879db2d1f1dc95af82b0b8af29e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.5

Release files / codemie_mcp_assistants-0.1.679-py3-none-any.whl

Download URL codemie_mcp_assistants-0.1.679-py3-none-any.whl
Size 6.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a0cd34380f984109098a54249363cefe88d9a5bc3da7d0715629f9e192b08140
BLAKE2b-256 checksum
How to use checksums
4f44e339f72cfbeb1fdcc00c00af1b2090d1aeac0653d742b209b71635539aa2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.5

Release history Release notifications | RSS feed

This release

0.1.679 This release

2 release files

0.1.91

2 release files

0.1.89

2 release files

0.1.88

2 release files

0.1.84

2 release files

0.1.82

2 release files

0.1.80

2 release files

0.1.78

2 release files

0.1.76

2 release files

0.1.70

2 release files

0.1.50

2 release files

0.1.48

2 release files

0.1.40

2 release files

0.1.36

2 release files

0.1.27

2 release files

0.1.22

2 release files

0.1.12

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page