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

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

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.596)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for artemzahumonnyi from gravatar.com artemzahumonnyi Avatar for epam-ai-run from gravatar.com epam-ai-run

Credits

Author: Vadym Vlasenko

Requires

Python <4.0, >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codemie_mcp_assistants-0.1.595.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codemie_mcp_assistants-0.1.595-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

Details for the file codemie_mcp_assistants-0.1.595.tar.gz.

File metadata

File hashes

Hashes for codemie_mcp_assistants-0.1.595.tar.gz
Algorithm Hash digest
SHA256 e3e370f994c9568a674c6825fae4f23014e64a009aaf28335632121bd1250284
MD5 7124dbbc6733c5adda037c26921efaba
BLAKE2b-256 ef182a16c5bea47757219d0eb48be8abc346fb66c9a1de9d31c44fb2a4dcbc68

See more details on using hashes here.

File details

Details for the file codemie_mcp_assistants-0.1.595-py3-none-any.whl.

File metadata

File hashes

Hashes for codemie_mcp_assistants-0.1.595-py3-none-any.whl
Algorithm Hash digest
SHA256 b5de9a4259abfb4d934cf06b3adbf3abc3939df9c219b75b263fd3ca99bfe00b
MD5 6151f8df9cf19d73c023c5796c0e5bd5
BLAKE2b-256 e3c95cf714067c1e3d206e35ff69cdba98e6dcabd60efecec6d8d37048ea76f5

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.596

2 files

This release

0.1.595 This release

2 files

0.1.594

2 files

0.1.593

2 files

0.1.592

2 files

0.1.591

2 files

0.1.590

2 files

0.1.589

2 files

0.1.588

2 files

0.1.587

2 files

0.1.586

2 files

0.1.585

2 files

0.1.584

2 files

0.1.580

2 files

0.1.579

2 files

0.1.578

2 files

0.1.577

2 files

0.1.576

2 files

0.1.575

2 files

0.1.574

2 files

0.1.573

2 files

0.1.572

2 files

0.1.571

2 files

0.1.570

2 files

0.1.569

2 files

0.1.567

2 files

0.1.566

2 files

0.1.565

2 files

0.1.564

2 files

0.1.563

2 files

0.1.562

2 files

0.1.561

2 files

0.1.560

2 files

0.1.559

2 files

0.1.558

2 files

0.1.557

2 files

0.1.556

2 files

0.1.555

2 files

0.1.554

2 files

0.1.553

2 files

0.1.552

2 files

0.1.551

2 files

0.1.550

2 files

0.1.547

2 files

0.1.546

2 files

0.1.545

2 files

0.1.544

2 files

0.1.543

2 files

0.1.542

2 files

0.1.541

2 files

0.1.540

2 files

0.1.539

2 files

0.1.538

2 files

0.1.537

2 files

0.1.536

2 files

0.1.535

2 files

0.1.534

2 files

0.1.533

2 files

0.1.532

2 files

0.1.531

2 files

0.1.530

2 files

0.1.529

2 files

0.1.528

2 files

0.1.527

2 files

0.1.526

2 files

0.1.525

2 files

0.1.524

2 files

0.1.523

2 files

0.1.522

2 files

0.1.521

2 files

0.1.520

2 files

0.1.519

2 files

0.1.518

2 files

0.1.517

2 files

0.1.516

2 files

0.1.515

2 files

0.1.514

2 files

0.1.513

2 files

0.1.512

2 files

0.1.511

2 files

0.1.510

2 files

0.1.509

2 files

0.1.508

2 files

0.1.507

2 files

0.1.506

2 files

0.1.505

2 files

0.1.504

2 files

0.1.503

2 files

0.1.502

2 files

0.1.501

2 files

0.1.500

2 files

0.1.499

2 files

0.1.498

2 files

0.1.497

2 files

0.1.496

2 files

0.1.495

2 files

0.1.487

2 files

0.1.486

2 files

0.1.485

2 files

0.1.484

2 files

0.1.483

2 files

0.1.482

2 files

0.1.481

2 files

0.1.480

2 files

0.1.479

2 files

0.1.478

2 files

0.1.477

2 files

0.1.476

2 files

0.1.475

2 files

0.1.474

2 files

0.1.473

2 files

0.1.472

2 files

0.1.471

2 files

0.1.469

2 files

0.1.468

2 files

0.1.467

2 files

0.1.466

2 files

0.1.465

2 files

0.1.464

2 files

0.1.463

2 files

0.1.462

2 files

0.1.461

2 files

0.1.460

2 files

0.1.459

2 files

0.1.458

2 files

0.1.457

2 files

0.1.456

2 files

0.1.455

2 files

0.1.454

2 files

0.1.453

2 files

0.1.452

2 files

0.1.451

2 files

0.1.450

2 files

0.1.449

2 files

0.1.448

2 files

0.1.447

2 files

0.1.446

2 files

0.1.435

2 files

0.1.434

2 files

0.1.433

2 files

0.1.432

2 files

0.1.431

2 files

0.1.430

2 files

0.1.429

2 files

0.1.428

2 files

0.1.427

2 files

0.1.426

2 files

0.1.425

2 files

0.1.424

2 files

0.1.423

2 files

0.1.422

2 files

0.1.421

2 files

0.1.420

2 files

0.1.419

2 files

0.1.418

2 files

0.1.416

2 files

0.1.415

2 files

0.1.414

2 files

0.1.413

2 files

0.1.412

2 files

0.1.411

2 files

0.1.410

2 files

0.1.409

2 files

0.1.408

2 files

0.1.407

2 files

0.1.406

2 files

0.1.405

2 files

0.1.404

2 files

0.1.403

2 files

0.1.402

2 files

0.1.401

2 files

0.1.400

2 files

0.1.399

2 files

0.1.398

2 files

0.1.397

2 files

0.1.396

2 files

0.1.395

2 files

0.1.394

2 files

0.1.393

2 files

0.1.392

2 files

0.1.391

2 files

0.1.390

2 files

0.1.389

2 files

0.1.388

2 files

0.1.387

2 files

0.1.386

2 files

0.1.384

2 files

0.1.383

2 files

0.1.382

2 files

0.1.381

2 files

0.1.380

2 files

0.1.379

2 files

0.1.378

2 files

0.1.377

2 files

0.1.376

2 files

0.1.375

2 files

0.1.374

2 files

0.1.369

2 files

0.1.368

2 files

0.1.367

2 files

0.1.366

2 files

0.1.365

2 files

0.1.364

2 files

0.1.363

2 files

0.1.362

2 files

0.1.361

2 files

0.1.360

2 files

0.1.359

2 files

0.1.358

2 files

0.1.357

2 files

0.1.356

2 files

0.1.355

2 files

0.1.354

2 files

0.1.353

2 files

0.1.352

2 files

0.1.351

2 files

0.1.335

2 files

0.1.334

2 files

0.1.333

2 files

0.1.332

2 files

0.1.331

2 files

0.1.330

2 files

0.1.329

2 files

0.1.328

2 files

0.1.327

2 files

0.1.326

2 files

0.1.325

2 files

0.1.324

2 files

0.1.323

2 files

0.1.322

2 files

0.1.321

2 files

0.1.320

2 files

0.1.319

2 files

0.1.311

2 files

0.1.310

2 files

0.1.309

2 files

0.1.308

2 files

0.1.307

2 files

0.1.306

2 files

0.1.305

2 files

0.1.304

2 files

0.1.303

2 files

0.1.302

2 files

0.1.301

2 files

0.1.300

2 files

0.1.299

2 files

0.1.298

2 files

0.1.297

2 files

0.1.296

2 files

0.1.295

2 files

0.1.294

2 files

0.1.293

2 files

0.1.292

2 files

0.1.291

2 files

0.1.290

2 files

0.1.289

2 files

0.1.288

2 files

0.1.287

2 files

0.1.286

2 files

0.1.285

2 files

0.1.284

2 files

0.1.283

2 files

0.1.282

2 files

0.1.281

2 files

0.1.280

2 files

0.1.279

2 files

0.1.278

2 files

0.1.277

2 files

0.1.276

2 files

0.1.275

2 files

0.1.274

2 files

0.1.273

2 files

0.1.272

2 files

0.1.271

2 files

0.1.270

2 files

0.1.268

2 files

0.1.267

2 files

0.1.266

2 files

0.1.262

2 files

0.1.261

2 files

0.1.260

2 files

0.1.259

2 files

0.1.258

2 files

0.1.257

2 files

0.1.256

2 files

0.1.255

2 files

0.1.254

2 files

0.1.253

2 files

0.1.252

2 files

0.1.251

2 files

0.1.250

2 files

0.1.249

2 files

0.1.248

2 files

0.1.247

2 files

0.1.246

2 files

0.1.238

2 files

0.1.237

2 files

0.1.236

2 files

0.1.235

2 files

0.1.234

2 files

0.1.233

2 files

0.1.232

2 files

0.1.231

2 files

0.1.230

2 files

0.1.229

2 files

0.1.228

2 files

0.1.227

2 files

0.1.226

2 files

0.1.225

2 files

0.1.224

2 files

0.1.223

2 files

0.1.222

2 files

0.1.221

2 files

0.1.219

2 files

0.1.218

2 files

0.1.217

2 files

0.1.216

2 files

0.1.215

2 files

0.1.214

2 files

0.1.213

2 files

0.1.212

2 files

0.1.211

2 files

0.1.210

2 files

0.1.209

2 files

0.1.208

2 files

0.1.207

2 files

0.1.206

2 files

0.1.205

2 files

0.1.204

2 files

0.1.203

2 files

0.1.202

2 files

0.1.201

2 files

0.1.200

2 files

0.1.199

2 files

0.1.198

2 files

0.1.197

2 files

0.1.183

2 files

0.1.182

2 files

0.1.181

2 files

0.1.180

2 files

0.1.179

2 files

0.1.178

2 files

0.1.177

2 files

0.1.176

2 files

0.1.175

2 files

0.1.174

2 files

0.1.173

2 files

0.1.172

2 files

0.1.171

2 files

0.1.170

2 files

0.1.169

2 files

0.1.168

2 files

0.1.167

2 files

0.1.166

2 files

0.1.165

2 files

0.1.164

2 files

0.1.163

2 files

0.1.162

2 files

0.1.161

2 files

0.1.160

2 files

0.1.159

2 files

0.1.158

2 files

0.1.157

2 files

0.1.156

2 files

0.1.155

2 files

0.1.154

2 files

0.1.153

2 files

0.1.152

2 files

0.1.151

2 files

0.1.150

2 files

0.1.149

2 files

0.1.148

2 files

0.1.147

2 files

0.1.146

2 files

0.1.145

2 files

0.1.144

2 files

0.1.143

2 files

0.1.142

2 files

0.1.141

2 files

0.1.140

2 files

0.1.139

2 files

0.1.138

2 files

0.1.137

2 files

0.1.136

2 files

0.1.135

2 files

0.1.134

2 files

0.1.133

2 files

0.1.132

2 files

0.1.131

2 files

0.1.130

2 files

0.1.129

2 files

0.1.128

2 files

0.1.127

2 files

0.1.126

2 files

0.1.125

2 files

0.1.124

2 files

0.1.123

2 files

0.1.122

2 files

0.1.121

2 files

0.1.120

2 files

0.1.116

2 files

0.1.112

2 files

0.1.106

2 files

0.1.105

2 files

0.1.102

2 files

0.1.100

2 files

0.1.97

2 files

0.1.91

2 files

0.1.89

2 files

0.1.88

2 files

0.1.84

2 files

0.1.82

2 files

0.1.80

2 files

0.1.78

2 files

0.1.76

2 files

0.1.70

2 files

0.1.69

2 files

0.1.67

2 files

0.1.66

2 files

0.1.55

2 files

0.1.50

2 files

0.1.48

2 files

0.1.40

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.32

2 files

0.1.27

2 files

0.1.22

2 files

0.1.12

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 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