CodeMie Datasources MCP Server

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

Features

List and filter datasources
Get datasource details
Create code datasources
Update datasources
Delete datasources
Monitor datasource processing status

Note: The server requires authentication credentials via environment variables.

API

Tools

list_datasources

Get list of available datasources with filtering and pagination Inputs:

page (integer, optional): Page number (default: 0)
per_page (integer, optional): Items per page (default: 10)
sort_key (string, optional): Sort by 'date' or 'update_date' (default: 'update_date')
sort_order (string, optional): Sort order 'asc' or 'desc' (default: 'desc')
datasource_types (array, optional): Filter by datasource types
projects (array, optional): Filter by project names
owner (string, optional): Filter by owner
status (string, optional): Filter by status

Returns list of datasources with their details

get_datasource

Get detailed information about a specific datasource Inputs:

datasource_id (string): ID of the datasource to retrieve

Returns complete datasource details including configuration

create_code_datasource

Create a new code datasource Inputs:

name (string): Datasource name (lowercase letters and underscores only)
description (string): Datasource description
project_name (string): Project name
repository_link (string): Git repository URL
branch (string): Git branch name
index_type (string, optional): Type of indexing - 'code', 'summary', or 'chunk-summary' (default: 'code')
files_filter (string, optional): File patterns to include/exclude
embeddings_model (string, optional): Model for embeddings generation
shared_with_project (boolean, optional): Whether datasource is shared with project (default: false)

Returns created datasource details

update_code_datasource

Update an existing code datasource Inputs:

datasource_id (string): ID of the datasource to update
name (string, optional): New name
description (string, optional): New description
branch (string, optional): New branch
files_filter (string, optional): New files filter
full_reindex (boolean, optional): Whether to perform full reindex
skip_reindex (boolean, optional): Whether to skip reindex
resume_indexing (boolean, optional): Whether to resume indexing

Returns updated datasource details

delete_datasource

Delete a datasource Inputs:

datasource_id (string): ID of the datasource to delete

Returns deletion confirmation

get_datasource_processing_info

Get datasource processing status and progress Inputs:

datasource_id (string): ID of the datasource to get info for

Returns processing information including status, progress, and file counts

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

uvx codemie-mcp-datasources

create_git_faq_datasource

Creates a Git FAQ datasource (knowledge_base_git_faq). Every .md file in the repository (narrowed only by the optional gitignore-style files_filter) is parsed as an FAQ article, split into embedded H1-H3 section chunks, and searched through the standard hybrid knowledge-base retrieval flow.

create_git_faq_datasource(
  name="team_faq",
  description="Team FAQ articles",
  project_name="my_project",
  repository_link="https://github.com/org/docs",
  branch="main",
  files_filter="docs/**/*.md\n!docs/internal/**",
)

Using Poetry

Alternatively you can install via Poetry:

poetry install codemie-mcp-datasources

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

poetry run codemie-mcp-datasources

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

Required variables:

"mcpServers": {
  "codemie-datasources": {
    "command": "uvx",
    "args": ["codemie-mcp-datasources"],
    "env": {
      "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-datasources": {
    "command": "poetry",
    "args": ["run", "codemie-mcp-datasources"],
    "env": {
      "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:

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

Release files for codemie-mcp-datasources 0.1.637

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-datasources 0.1.637
File	Size	Uploaded
codemie_mcp_datasources-0.1.637.tar.gz	5.4 kB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for codemie-mcp-datasources 0.1.637
File	Interpreter	ABI	Platform	Reset
codemie_mcp_datasources-0.1.637-py3-none-any.whl 6.3 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 11.7 kB

Release files / codemie_mcp_datasources-0.1.637.tar.gz

Download URL	codemie_mcp_datasources-0.1.637.tar.gz
Size	5.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`20cba60b8d9a0ad52e33a7ce1b3a0068168686899b2100d83c95deec0d556002`
BLAKE2b-256 checksum How to use checksums	`76861a78b9f4bc449676b64e455db2c6087bb1ef61e37e237e0e68da0a7ef2aa`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.5`

Release files / codemie_mcp_datasources-0.1.637-py3-none-any.whl

Download URL	codemie_mcp_datasources-0.1.637-py3-none-any.whl
Size	6.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`597a4a7013c8d71c580e61edae493b5437426e84c520c89bb650919f0f342a3c`
BLAKE2b-256 checksum How to use checksums	`73e376ff78af30f8c2e6a1a218421c03d14fda13d91d1de8db5b407c02c0f4fc`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.5`