codemie-mcp-datasources 0.1.225__tar.gz → 0.1.248__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of codemie-mcp-datasources might be problematic. Click here for more details.

@@ -0,0 +1,231 @@
1
+ Metadata-Version: 2.1
2
+ Name: codemie-mcp-datasources
3
+ Version: 0.1.248
4
+ Summary: MCP server for connecting to CodeMie Datasources
5
+ Author: Nikita Levyankov
6
+ Author-email: nikita_levyankov@epam.com
7
+ Requires-Python: >=3.12,<4.0
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: Programming Language :: Python :: 3.12
10
+ Requires-Dist: certifi (>=2025.1.31,<2026.0.0)
11
+ Requires-Dist: codemie-sdk-python (==0.1.248)
12
+ Requires-Dist: httpx (>=0.27.0,<0.28.0)
13
+ Requires-Dist: mcp (>=1.6.0,<2.0.0)
14
+ Description-Content-Type: text/markdown
15
+
16
+ # CodeMie Datasources MCP Server
17
+
18
+ Python server implementing Model Context Protocol (MCP) for CodeMie Datasources operations.
19
+
20
+ ## Features
21
+ - List and filter datasources
22
+ - Get datasource details
23
+ - Create code datasources
24
+ - Update datasources
25
+ - Delete datasources
26
+ - Monitor datasource processing status
27
+
28
+ Note: The server requires authentication credentials via environment variables.
29
+
30
+ ## API
31
+
32
+ ### Tools
33
+
34
+ #### list_datasources
35
+ Get list of available datasources with filtering and pagination
36
+ Inputs:
37
+ - `page (integer, optional)`: Page number (default: 0)
38
+ - `per_page (integer, optional)`: Items per page (default: 10)
39
+ - `sort_key (string, optional)`: Sort by 'date' or 'update_date' (default: 'update_date')
40
+ - `sort_order (string, optional)`: Sort order 'asc' or 'desc' (default: 'desc')
41
+ - `datasource_types (array, optional)`: Filter by datasource types
42
+ - `projects (array, optional)`: Filter by project names
43
+ - `owner (string, optional)`: Filter by owner
44
+ - `status (string, optional)`: Filter by status
45
+
46
+ Returns list of datasources with their details
47
+
48
+ #### get_datasource
49
+ Get detailed information about a specific datasource
50
+ Inputs:
51
+ - `datasource_id (string)`: ID of the datasource to retrieve
52
+
53
+ Returns complete datasource details including configuration
54
+
55
+ #### create_code_datasource
56
+ Create a new code datasource
57
+ Inputs:
58
+ - `name (string)`: Datasource name (lowercase letters and underscores only)
59
+ - `description (string)`: Datasource description
60
+ - `project_name (string)`: Project name
61
+ - `repository_link (string)`: Git repository URL
62
+ - `branch (string)`: Git branch name
63
+ - `index_type (string, optional)`: Type of indexing - 'code', 'summary', or 'chunk-summary' (default: 'code')
64
+ - `files_filter (string, optional)`: File patterns to include/exclude
65
+ - `embeddings_model (string, optional)`: Model for embeddings generation
66
+ - `shared_with_project (boolean, optional)`: Whether datasource is shared with project (default: false)
67
+
68
+ Returns created datasource details
69
+
70
+ #### update_code_datasource
71
+ Update an existing code datasource
72
+ Inputs:
73
+ - `datasource_id (string)`: ID of the datasource to update
74
+ - `name (string, optional)`: New name
75
+ - `description (string, optional)`: New description
76
+ - `branch (string, optional)`: New branch
77
+ - `files_filter (string, optional)`: New files filter
78
+ - `full_reindex (boolean, optional)`: Whether to perform full reindex
79
+ - `skip_reindex (boolean, optional)`: Whether to skip reindex
80
+ - `resume_indexing (boolean, optional)`: Whether to resume indexing
81
+
82
+ Returns updated datasource details
83
+
84
+ #### delete_datasource
85
+ Delete a datasource
86
+ Inputs:
87
+ - `datasource_id (string)`: ID of the datasource to delete
88
+
89
+ Returns deletion confirmation
90
+
91
+ #### get_datasource_processing_info
92
+ Get datasource processing status and progress
93
+ Inputs:
94
+ - `datasource_id (string)`: ID of the datasource to get info for
95
+
96
+ Returns processing information including status, progress, and file counts
97
+
98
+ ## Installation
99
+
100
+ Ensure you have `Python 3.12` or later installed.
101
+
102
+ **Important:** Before running the MCP server, you must configure the required environment variables (see [Environment Variables](#environment-variables) section below).
103
+
104
+ ### Using uv (recommended)
105
+
106
+ When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
107
+ use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *codemie-mcp-datasources*.
108
+
109
+ ```bash
110
+ uvx codemie-mcp-datasources
111
+ ```
112
+
113
+ ### Using Poetry
114
+
115
+ Alternatively you can install via Poetry:
116
+
117
+ ```bash
118
+ poetry install codemie-mcp-datasources
119
+ ```
120
+
121
+ After installation, you can run it as a script using:
122
+
123
+ ```bash
124
+ poetry run codemie-mcp-datasources
125
+ ```
126
+
127
+ ## Configuration
128
+
129
+ ### Configure for Claude.app
130
+
131
+ Add to your Claude settings:
132
+
133
+ <details>
134
+ <summary>Using uvx</summary>
135
+
136
+ **Required variables:**
137
+ ```json
138
+ "mcpServers": {
139
+ "codemie-datasources": {
140
+ "command": "uvx",
141
+ "args": ["codemie-mcp-datasources"],
142
+ "env": {
143
+ "CODEMIE_USERNAME": "your-username",
144
+ "CODEMIE_PASSWORD": "your-password"
145
+ }
146
+ }
147
+ }
148
+ ```
149
+
150
+ **Optional variables (with defaults):**
151
+ ```json
152
+ "env": {
153
+ "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
154
+ "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
155
+ "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
156
+ "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
157
+ }
158
+ ```
159
+ </details>
160
+
161
+ <details>
162
+ <summary>Using poetry installation</summary>
163
+
164
+ **Required variables:**
165
+ ```json
166
+ "mcpServers": {
167
+ "codemie-datasources": {
168
+ "command": "poetry",
169
+ "args": ["run", "codemie-mcp-datasources"],
170
+ "env": {
171
+ "CODEMIE_USERNAME": "your-username",
172
+ "CODEMIE_PASSWORD": "your-password"
173
+ }
174
+ }
175
+ }
176
+ ```
177
+
178
+ **Optional variables (with defaults):**
179
+ ```json
180
+ "env": {
181
+ "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
182
+ "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
183
+ "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
184
+ "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
185
+ }
186
+ ```
187
+ </details>
188
+
189
+ ### Environment Variables
190
+
191
+ #### Mandatory Variables
192
+
193
+ The following environment variables **must** be configured before running the MCP server:
194
+
195
+ **Authentication (choose one method):**
196
+
197
+ *Option 1: Username/Password*
198
+ - `CODEMIE_USERNAME`: Your CodeMie username
199
+ - `CODEMIE_PASSWORD`: Your CodeMie password
200
+
201
+ *Option 2: Client Credentials*
202
+ - `CODEMIE_AUTH_CLIENT_SECRET`: Auth client secret
203
+
204
+ #### Optional Variables (Environment-Specific)
205
+
206
+ By default, the server connects to the **production environment** with these settings:
207
+ - `CODEMIE_API_DOMAIN`: `https://codemie.lab.epam.com/code-assistant-api`
208
+ - `CODEMIE_AUTH_CLIENT_ID`: `codemie-sdk`
209
+ - `CODEMIE_AUTH_SERVER_URL`: `https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth`
210
+ - `CODEMIE_AUTH_REALM_NAME`: `codemie-prod`
211
+
212
+ You can override these variables to point to a different environment.
213
+
214
+ **Example: Preview Environment Configuration**
215
+ ```bash
216
+ CODEMIE_API_DOMAIN="https://codemie-preview.lab.epam.com/code-assistant-api"
217
+ CODEMIE_AUTH_CLIENT_ID="codemie-preview-sdk"
218
+ CODEMIE_AUTH_SERVER_URL="https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth"
219
+ CODEMIE_AUTH_REALM_NAME="codemie-prod"
220
+ ```
221
+
222
+ **Other Optional Variables:**
223
+ - `CODEMIE_VERIFY_SSL`: SSL verification flag (default: `true`)
224
+
225
+ ## Build
226
+
227
+ ### Make build:
228
+ ```bash
229
+ make build
230
+ ```
231
+
@@ -0,0 +1,215 @@
1
+ # CodeMie Datasources MCP Server
2
+
3
+ Python server implementing Model Context Protocol (MCP) for CodeMie Datasources operations.
4
+
5
+ ## Features
6
+ - List and filter datasources
7
+ - Get datasource details
8
+ - Create code datasources
9
+ - Update datasources
10
+ - Delete datasources
11
+ - Monitor datasource processing status
12
+
13
+ Note: The server requires authentication credentials via environment variables.
14
+
15
+ ## API
16
+
17
+ ### Tools
18
+
19
+ #### list_datasources
20
+ Get list of available datasources with filtering and pagination
21
+ Inputs:
22
+ - `page (integer, optional)`: Page number (default: 0)
23
+ - `per_page (integer, optional)`: Items per page (default: 10)
24
+ - `sort_key (string, optional)`: Sort by 'date' or 'update_date' (default: 'update_date')
25
+ - `sort_order (string, optional)`: Sort order 'asc' or 'desc' (default: 'desc')
26
+ - `datasource_types (array, optional)`: Filter by datasource types
27
+ - `projects (array, optional)`: Filter by project names
28
+ - `owner (string, optional)`: Filter by owner
29
+ - `status (string, optional)`: Filter by status
30
+
31
+ Returns list of datasources with their details
32
+
33
+ #### get_datasource
34
+ Get detailed information about a specific datasource
35
+ Inputs:
36
+ - `datasource_id (string)`: ID of the datasource to retrieve
37
+
38
+ Returns complete datasource details including configuration
39
+
40
+ #### create_code_datasource
41
+ Create a new code datasource
42
+ Inputs:
43
+ - `name (string)`: Datasource name (lowercase letters and underscores only)
44
+ - `description (string)`: Datasource description
45
+ - `project_name (string)`: Project name
46
+ - `repository_link (string)`: Git repository URL
47
+ - `branch (string)`: Git branch name
48
+ - `index_type (string, optional)`: Type of indexing - 'code', 'summary', or 'chunk-summary' (default: 'code')
49
+ - `files_filter (string, optional)`: File patterns to include/exclude
50
+ - `embeddings_model (string, optional)`: Model for embeddings generation
51
+ - `shared_with_project (boolean, optional)`: Whether datasource is shared with project (default: false)
52
+
53
+ Returns created datasource details
54
+
55
+ #### update_code_datasource
56
+ Update an existing code datasource
57
+ Inputs:
58
+ - `datasource_id (string)`: ID of the datasource to update
59
+ - `name (string, optional)`: New name
60
+ - `description (string, optional)`: New description
61
+ - `branch (string, optional)`: New branch
62
+ - `files_filter (string, optional)`: New files filter
63
+ - `full_reindex (boolean, optional)`: Whether to perform full reindex
64
+ - `skip_reindex (boolean, optional)`: Whether to skip reindex
65
+ - `resume_indexing (boolean, optional)`: Whether to resume indexing
66
+
67
+ Returns updated datasource details
68
+
69
+ #### delete_datasource
70
+ Delete a datasource
71
+ Inputs:
72
+ - `datasource_id (string)`: ID of the datasource to delete
73
+
74
+ Returns deletion confirmation
75
+
76
+ #### get_datasource_processing_info
77
+ Get datasource processing status and progress
78
+ Inputs:
79
+ - `datasource_id (string)`: ID of the datasource to get info for
80
+
81
+ Returns processing information including status, progress, and file counts
82
+
83
+ ## Installation
84
+
85
+ Ensure you have `Python 3.12` or later installed.
86
+
87
+ **Important:** Before running the MCP server, you must configure the required environment variables (see [Environment Variables](#environment-variables) section below).
88
+
89
+ ### Using uv (recommended)
90
+
91
+ When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
92
+ use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *codemie-mcp-datasources*.
93
+
94
+ ```bash
95
+ uvx codemie-mcp-datasources
96
+ ```
97
+
98
+ ### Using Poetry
99
+
100
+ Alternatively you can install via Poetry:
101
+
102
+ ```bash
103
+ poetry install codemie-mcp-datasources
104
+ ```
105
+
106
+ After installation, you can run it as a script using:
107
+
108
+ ```bash
109
+ poetry run codemie-mcp-datasources
110
+ ```
111
+
112
+ ## Configuration
113
+
114
+ ### Configure for Claude.app
115
+
116
+ Add to your Claude settings:
117
+
118
+ <details>
119
+ <summary>Using uvx</summary>
120
+
121
+ **Required variables:**
122
+ ```json
123
+ "mcpServers": {
124
+ "codemie-datasources": {
125
+ "command": "uvx",
126
+ "args": ["codemie-mcp-datasources"],
127
+ "env": {
128
+ "CODEMIE_USERNAME": "your-username",
129
+ "CODEMIE_PASSWORD": "your-password"
130
+ }
131
+ }
132
+ }
133
+ ```
134
+
135
+ **Optional variables (with defaults):**
136
+ ```json
137
+ "env": {
138
+ "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
139
+ "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
140
+ "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
141
+ "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
142
+ }
143
+ ```
144
+ </details>
145
+
146
+ <details>
147
+ <summary>Using poetry installation</summary>
148
+
149
+ **Required variables:**
150
+ ```json
151
+ "mcpServers": {
152
+ "codemie-datasources": {
153
+ "command": "poetry",
154
+ "args": ["run", "codemie-mcp-datasources"],
155
+ "env": {
156
+ "CODEMIE_USERNAME": "your-username",
157
+ "CODEMIE_PASSWORD": "your-password"
158
+ }
159
+ }
160
+ }
161
+ ```
162
+
163
+ **Optional variables (with defaults):**
164
+ ```json
165
+ "env": {
166
+ "CODEMIE_API_DOMAIN": "https://codemie.lab.epam.com/code-assistant-api",
167
+ "CODEMIE_AUTH_CLIENT_ID": "codemie-sdk",
168
+ "CODEMIE_AUTH_SERVER_URL": "https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth",
169
+ "CODEMIE_AUTH_REALM_NAME": "codemie-prod"
170
+ }
171
+ ```
172
+ </details>
173
+
174
+ ### Environment Variables
175
+
176
+ #### Mandatory Variables
177
+
178
+ The following environment variables **must** be configured before running the MCP server:
179
+
180
+ **Authentication (choose one method):**
181
+
182
+ *Option 1: Username/Password*
183
+ - `CODEMIE_USERNAME`: Your CodeMie username
184
+ - `CODEMIE_PASSWORD`: Your CodeMie password
185
+
186
+ *Option 2: Client Credentials*
187
+ - `CODEMIE_AUTH_CLIENT_SECRET`: Auth client secret
188
+
189
+ #### Optional Variables (Environment-Specific)
190
+
191
+ By default, the server connects to the **production environment** with these settings:
192
+ - `CODEMIE_API_DOMAIN`: `https://codemie.lab.epam.com/code-assistant-api`
193
+ - `CODEMIE_AUTH_CLIENT_ID`: `codemie-sdk`
194
+ - `CODEMIE_AUTH_SERVER_URL`: `https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth`
195
+ - `CODEMIE_AUTH_REALM_NAME`: `codemie-prod`
196
+
197
+ You can override these variables to point to a different environment.
198
+
199
+ **Example: Preview Environment Configuration**
200
+ ```bash
201
+ CODEMIE_API_DOMAIN="https://codemie-preview.lab.epam.com/code-assistant-api"
202
+ CODEMIE_AUTH_CLIENT_ID="codemie-preview-sdk"
203
+ CODEMIE_AUTH_SERVER_URL="https://keycloak.eks-core.aws.main.edp.projects.epam.com/auth"
204
+ CODEMIE_AUTH_REALM_NAME="codemie-prod"
205
+ ```
206
+
207
+ **Other Optional Variables:**
208
+ - `CODEMIE_VERIFY_SSL`: SSL verification flag (default: `true`)
209
+
210
+ ## Build
211
+
212
+ ### Make build:
213
+ ```bash
214
+ make build
215
+ ```
@@ -1,20 +1,20 @@
1
1
  [project]
2
2
  name = "codemie-mcp-datasources"
3
- version = "0.1.3"
3
+ version = "0.1.4"
4
4
  description = "MCP server for connecting to CodeMie Datasources"
5
- #readme = "README.md"
5
+ readme = "README.md"
6
6
  packages = [
7
7
  { include = "datasources_mcp", from = "src" }
8
8
  ]
9
9
 
10
10
  [tool.poetry]
11
11
  name = "codemie-mcp-datasources"
12
- version = "0.1.225"
12
+ version = "0.1.248"
13
13
  description = "MCP server for connecting to CodeMie Datasources"
14
14
  authors = [
15
15
  "Nikita Levyankov <nikita_levyankov@epam.com>",
16
16
  ]
17
- #readme = "README.md"
17
+ readme = "README.md"
18
18
  packages = [
19
19
  { include = "src" }
20
20
  ]
@@ -23,7 +23,7 @@ packages = [
23
23
  python = "^3.12"
24
24
  mcp = "^1.6.0"
25
25
  httpx = "^0.27.0"
26
- codemie-sdk-python = "0.1.225"
26
+ codemie-sdk-python = "0.1.248"
27
27
  certifi = "^2025.1.31"
28
28
 
29
29
  [tool.poetry.group.dev.dependencies]
@@ -1,13 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: codemie-mcp-datasources
3
- Version: 0.1.225
4
- Summary: MCP server for connecting to CodeMie Datasources
5
- Author: Nikita Levyankov
6
- Author-email: nikita_levyankov@epam.com
7
- Requires-Python: >=3.12,<4.0
8
- Classifier: Programming Language :: Python :: 3
9
- Classifier: Programming Language :: Python :: 3.12
10
- Requires-Dist: certifi (>=2025.1.31,<2026.0.0)
11
- Requires-Dist: codemie-sdk-python (==0.1.225)
12
- Requires-Dist: httpx (>=0.27.0,<0.28.0)
13
- Requires-Dist: mcp (>=1.6.0,<2.0.0)