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
Release files for codemie-mcp-assistants 0.1.625
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| codemie_mcp_assistants-0.1.625.tar.gz | 5.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codemie_mcp_assistants-0.1.625-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.6 kB
Release files / codemie_mcp_assistants-0.1.625.tar.gz
| Download URL | codemie_mcp_assistants-0.1.625.tar.gz |
|---|---|
| Size | 5.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f615064e912713e9f4de877e3acaac8f3323edd086867348768e42a0df9b8189
|
|
BLAKE2b-256 checksum How to use checksums |
a578cc7322cd3e93a32560b12c1c2c310270907fa23541584d49d4ec3d3612de
|
| 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.625-py3-none-any.whl
| Download URL | codemie_mcp_assistants-0.1.625-py3-none-any.whl |
|---|---|
| Size | 6.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d32107fef939955e974b8d848176191f8650dce5bc3abac6ae299d8854686dc1
|
|
BLAKE2b-256 checksum How to use checksums |
c202f7d65cab298d27fed3c95986298b5b75a28f83bc44099baf23f7469d469c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.5
|
