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 assistantconversation_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).
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_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 usernameCODEMIE_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-apiCODEMIE_AUTH_CLIENT_ID:codemie-sdkCODEMIE_AUTH_SERVER_URL:https://keycloak.eks-core.aws.main.edp.projects.epam.com/authCODEMIE_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
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codemie_mcp_assistants-0.1.500.tar.gz.
File metadata
- Download URL: codemie_mcp_assistants-0.1.500.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
042e353941a89c422c18c918ed70ccaa6c4a6164894417a7ca3886e0ce4b8f32
|
|
| MD5 |
012651c1c04a54fe9f9130c4517a0014
|
|
| BLAKE2b-256 |
55a3c6bb215a45970cbd89c4c97e8b4356d407de1716f774b26652683fdd1b9a
|
File details
Details for the file codemie_mcp_assistants-0.1.500-py3-none-any.whl.
File metadata
- Download URL: codemie_mcp_assistants-0.1.500-py3-none-any.whl
- Upload date:
- Size: 6.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c5cff16ce23676aadb43703e7d2875aa5670ba78a94eb045d5fcf83668236604
|
|
| MD5 |
2f6cd08c66e4ed0af0b60e5199200e27
|
|
| BLAKE2b-256 |
ff1767ed3df92848155981ea36b9ec5562e13a7147df4acc2bc13addbbdfccd8
|
