codemie-mcp-assistants 0.1.227__py3-none-any.whl → 0.1.302__py3-none-any.whl

{codemie_mcp_assistants-0.1.227.dist-info → codemie_mcp_assistants-0.1.302.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codemie-mcp-assistants
-Version: 0.1.227
+Version: 0.1.302
 Summary: MCP server for connecting to CodeMie Assistants API
 Author: Vadym Vlasenko
 Author-email: vadym_vlasenko@epam.com
@@ -8,7 +8,7 @@ Requires-Python: >=3.12,<4.0
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: certifi (>=2025.1.31,<2026.0.0)
-Requires-Dist: codemie-sdk-python (==0.1.227)
+Requires-Dist: codemie-sdk-python (==0.1.302)
 Requires-Dist: httpx (>=0.28.1,<0.29.0)
 Requires-Dist: mcp (>=1.6.0,<2.0.0)
 Requires-Dist: pydantic (>=2.11.2,<3.0.0)
@@ -41,6 +41,8 @@ Returns generated assistant response as text
 
 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](#environment-variables) section below).
+
 ### Using uv (recommended)
 
 When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
@@ -73,51 +75,99 @@ Add to your Claude settings:
 <details>
 <summary>Using uvx</summary>
 
+**Required variables:**
 ```json
 "mcpServers": {
   "codemie": {
     "command": "uvx",
     "args": ["codemie-mcp-assistants"],
     "env": {
-      "CODEMIE_ASSISTANT_ID": "your-assistant-id"
+      "CODEMIE_ASSISTANT_ID": "your-assistant-id",
       "CODEMIE_USERNAME": "your-username",
       "CODEMIE_PASSWORD": "your-password"
     }
   }
 }
 ```
+
+**Optional variables (with defaults):**
+```json
+"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"
+}
+```
 </details>
 
 <details>
 <summary>Using poetry installation</summary>
 
+**Required variables:**
 ```json
 "mcpServers": {
   "codemie": {
     "command": "poetry",
     "args": ["run", "codemie-mcp-assistants"],
     "env": {
-      "CODEMIE_ASSISTANT_ID": "your-assistant-id"
+      "CODEMIE_ASSISTANT_ID": "your-assistant-id",
       "CODEMIE_USERNAME": "your-username",
       "CODEMIE_PASSWORD": "your-password"
     }
   }
 }
 ```
+
+**Optional variables (with defaults):**
+```json
+"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"
+}
+```
 </details>
 
 ### Environment Variables
 
-- `CODEMIE_ASSISTANT_ID`: "AI/Run CodeMie assistant UID"
+#### Mandatory Variables
 
-The following environment variables are required for authentication:
+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
 
-Optional configuration:
-- `CODEMIE_AUTH_CLIENT_ID`: Auth client ID (default: "codemie-sdk")
-- `CODEMIE_AUTH_REALM_NAME`: Auth realm name (default: "codemie-prod")
+*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**
+```bash
+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
 

codemie_mcp_assistants-0.1.302.dist-info/RECORD

@@ -0,0 +1,6 @@
+src/model.py,sha256=_mPLj0Kvr6eQJUPRio7i69dxv1BEB1DYeDe4aHpQxBk,4304
+src/server.py,sha256=LXnjrr3gdH029DuP-lRnw2erVXab0pybF0Z1EXUiUhQ,7982
+codemie_mcp_assistants-0.1.302.dist-info/METADATA,sha256=awdHr1MNGUtrVj6I2iM1bQja7bWF2DLuSfD6zdaUwks,4783
+codemie_mcp_assistants-0.1.302.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+codemie_mcp_assistants-0.1.302.dist-info/entry_points.txt,sha256=mialsNMpA-NT-iPWuPimHMzE0OZcT3c7Fv7xmUcx_IU,58
+codemie_mcp_assistants-0.1.302.dist-info/RECORD,,

src/server.py

@@ -1,5 +1,6 @@
 import sys
 import uuid
+import re
 from typing import Dict, List
 
 from codemie_sdk import CodeMieClient
@@ -45,6 +46,37 @@ def get_client() -> CodeMieClient:
         raise
 
 
+def sanitize_tool_name(name: str) -> str:
+    """
+    Sanitize a tool name to match MCP requirements.
+
+    MCP tool names must match pattern: ^[a-zA-Z0-9_-]{1,64}$
+    - Only alphanumeric characters, underscores, and hyphens allowed
+    - Must be 1-64 characters long
+
+    Args:
+        name: The original name to sanitize
+
+    Returns:
+        str: Sanitized name matching the pattern
+    """
+    # Convert to lowercase and replace spaces with underscores
+    sanitized = name.lower().replace(" ", "_")
+
+    # Remove any characters that are not alphanumeric, underscore, or hyphen
+    sanitized = re.sub(r"[^a-z0-9_-]", "", sanitized)
+
+    # Ensure name is not empty after sanitization
+    if not sanitized:
+        sanitized = "assistant"
+
+    # Truncate to 64 characters if needed
+    if len(sanitized) > 60:
+        sanitized = sanitized[:64]
+
+    return sanitized
+
+
 def get_assistant_info(assistant_id: str) -> AssistantInfo:
     """
     Retrieve and validate assistant information.
@@ -84,7 +116,7 @@ mcp = FastMCP("codemie-assistants")
 # Get and validate assistant by identifier.
 codemie_assistant = get_assistant_info(settings.assistant_id)
 
-chat_tool_name = "ask_" + codemie_assistant.name.lower().replace(" ", "_")
+chat_tool_name = "ask_" + sanitize_tool_name(codemie_assistant.name)
 chat_assistant_tool_description = (
     f"""
 This tool allows to ask and communicate with '{codemie_assistant.name}'.

codemie_mcp_assistants-0.1.227.dist-info/RECORD

@@ -1,6 +0,0 @@
-src/model.py,sha256=_mPLj0Kvr6eQJUPRio7i69dxv1BEB1DYeDe4aHpQxBk,4304
-src/server.py,sha256=C3MD3QfnUFV1gmLPATaqkuJvZNGuHEc7xK-mIW8R37M,7107
-codemie_mcp_assistants-0.1.227.dist-info/METADATA,sha256=MI9QqIKjuxfKiYgb6u53M93rDkcoW8Gktl-_fxLnGFI,2987
-codemie_mcp_assistants-0.1.227.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-codemie_mcp_assistants-0.1.227.dist-info/entry_points.txt,sha256=mialsNMpA-NT-iPWuPimHMzE0OZcT3c7Fv7xmUcx_IU,58
-codemie_mcp_assistants-0.1.227.dist-info/RECORD,,