commit-check-mcp 0.1.4__tar.gz → 0.1.5__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.
Files changed (24) hide show
  1. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.github/workflows/main.yml +3 -3
  2. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.github/workflows/publish.yml +1 -1
  3. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/PKG-INFO +157 -10
  4. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/README.md +156 -9
  5. commit_check_mcp-0.1.5/server.json +36 -0
  6. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/PKG-INFO +157 -10
  7. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/SOURCES.txt +3 -0
  8. commit_check_mcp-0.1.5/src/commit_check_mcp.egg-info/scm_file_list.json +18 -0
  9. commit_check_mcp-0.1.5/src/commit_check_mcp.egg-info/scm_version.json +8 -0
  10. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.github/dependabot.yml +0 -0
  11. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.github/workflows/labeler.yml +0 -0
  12. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.github/workflows/release-drafter.yml +0 -0
  13. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/.gitignore +0 -0
  14. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/LICENSE +0 -0
  15. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/pyproject.toml +0 -0
  16. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/setup.cfg +0 -0
  17. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp/__init__.py +0 -0
  18. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp/server.py +0 -0
  19. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/dependency_links.txt +0 -0
  20. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/entry_points.txt +0 -0
  21. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/requires.txt +0 -0
  22. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/src/commit_check_mcp.egg-info/top_level.txt +0 -0
  23. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/tests/test_server.py +0 -0
  24. {commit_check_mcp-0.1.4 → commit_check_mcp-0.1.5}/uv.lock +0 -0
@@ -24,7 +24,7 @@ jobs:
24
24
  matrix:
25
25
  python-version: ["3.10", "3.11", "3.12", "3.13"]
26
26
  steps:
27
- - uses: actions/checkout@v6
27
+ - uses: actions/checkout@v7
28
28
  - uses: actions/setup-python@v6
29
29
  with:
30
30
  python-version: ${{ matrix.python-version }}
@@ -39,7 +39,7 @@ jobs:
39
39
 
40
40
  - name: Upload coverage reports to Codecov
41
41
  if: matrix.python-version == '3.12'
42
- uses: codecov/codecov-action@v6
42
+ uses: codecov/codecov-action@v7
43
43
  with:
44
44
  token: ${{ secrets.CODECOV_TOKEN }}
45
45
  slug: commit-check/commit-check-mcp
@@ -48,7 +48,7 @@ jobs:
48
48
  build:
49
49
  runs-on: ubuntu-24.04
50
50
  steps:
51
- - uses: actions/checkout@v6
51
+ - uses: actions/checkout@v7
52
52
  - uses: actions/setup-python@v6
53
53
  with:
54
54
  python-version: "3.12"
@@ -20,7 +20,7 @@ jobs:
20
20
  outputs:
21
21
  artifact-name: python-package-distributions
22
22
  steps:
23
- - uses: actions/checkout@v6
23
+ - uses: actions/checkout@v7
24
24
  with:
25
25
  fetch-depth: 0
26
26
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: commit-check-mcp
3
- Version: 0.1.4
3
+ Version: 0.1.5
4
4
  Summary: MCP server exposing commit-check validation tools
5
5
  Author-email: Xianpeng Shen <xianpeng.shen@gmail.com>
6
6
  License: MIT
@@ -27,11 +27,15 @@ Dynamic: license-file
27
27
 
28
28
  # commit-check-mcp
29
29
 
30
+ mcp-name: io.github.commit-check/commit-check-mcp
31
+
30
32
  [![PyPI version](https://img.shields.io/pypi/v/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
31
33
  [![Python versions](https://img.shields.io/pypi/pyversions/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
32
34
  [![Build](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml/badge.svg)](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml)
33
35
  [![Coverage](https://codecov.io/gh/commit-check/commit-check-mcp/graph/badge.svg)](https://codecov.io/gh/commit-check/commit-check-mcp)
34
36
  [![MCP server](https://img.shields.io/badge/MCP-server-0A7B83)](https://modelcontextprotocol.io/)
37
+ [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.commit--check/commit--check--mcp-7B3F00)](https://registry.modelcontextprotocol.io/)
38
+ [![Glama](https://img.shields.io/badge/Glama-commit--check--mcp-blue)](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp)
35
39
 
36
40
  Model Context Protocol (MCP) server for [commit-check](https://github.com/commit-check/commit-check).
37
41
 
@@ -85,44 +89,174 @@ pip install -e .
85
89
 
86
90
  This server runs over stdio, so it is meant to be launched by an MCP client rather than used as a long-running HTTP service.
87
91
 
88
- Generic MCP client config:
92
+ With `uvx` (recommended — no install needed):
93
+
94
+ ```bash
95
+ # Run once, no pip install required
96
+ uvx commit-check-mcp
97
+ ```
98
+
99
+ > **Tip**: If `uv` is not installed, get it via `curl -LsSf https://astral.sh/uv/install.sh | sh`.
100
+
101
+ ---
102
+
103
+ ### Claude Desktop
89
104
 
90
105
  ```json
91
106
  {
92
107
  "mcpServers": {
93
108
  "commit-check": {
94
- "command": "commit-check-mcp"
109
+ "command": "uvx",
110
+ "args": ["commit-check-mcp"]
95
111
  }
96
112
  }
97
113
  }
98
114
  ```
99
115
 
100
- If the client needs the full path to the executable, first locate it:
116
+ ### Claude Code CLI
101
117
 
102
- ```bash
103
- which commit-check-mcp
118
+ ```json
119
+ {
120
+ "mcpServers": {
121
+ "commit-check": {
122
+ "command": "uvx",
123
+ "args": ["commit-check-mcp"]
124
+ }
125
+ }
126
+ }
127
+ ```
128
+
129
+ Add to your `~/.claude/settings.json` or project-level `.claude/settings.local.json`.
130
+
131
+ ### Cursor
132
+
133
+ In Cursor, go to **Settings → Cursor Settings → MCP → Add new MCP server** and paste:
134
+
135
+ | Field | Value |
136
+ |---|---|
137
+ | **Name** | `commit-check` |
138
+ | **Type** | `command` |
139
+ | **Command** | `uvx commit-check-mcp` |
140
+
141
+ Or add to your project's `.cursor/mcp.json`:
142
+
143
+ ```json
144
+ {
145
+ "mcpServers": {
146
+ "commit-check": {
147
+ "command": "uvx",
148
+ "args": ["commit-check-mcp"]
149
+ }
150
+ }
151
+ }
152
+ ```
153
+
154
+ ### Windsurf
155
+
156
+ Add to your `~/.codeium/windsurf/mcp_config.json`:
157
+
158
+ ```json
159
+ {
160
+ "mcpServers": {
161
+ "commit-check": {
162
+ "command": "uvx",
163
+ "args": ["commit-check-mcp"]
164
+ }
165
+ }
166
+ }
167
+ ```
168
+
169
+ ### Cline (VS Code)
170
+
171
+ Add a new MCP server in the Cline extension settings:
172
+
173
+ ```json
174
+ {
175
+ "mcpServers": {
176
+ "commit-check": {
177
+ "command": "uvx",
178
+ "args": ["commit-check-mcp"]
179
+ }
180
+ }
181
+ }
104
182
  ```
105
183
 
106
- Then use that absolute path in the client config.
184
+ ### Continue.dev (VS Code / JetBrains)
107
185
 
108
- Example using an absolute path:
186
+ Add to your `~/.continue/config.json`:
187
+
188
+ ```json
189
+ {
190
+ "experimental": {
191
+ "mcpServers": {
192
+ "commit-check": {
193
+ "command": "uvx",
194
+ "args": ["commit-check-mcp"]
195
+ }
196
+ }
197
+ }
198
+ }
199
+ ```
200
+
201
+ ### Roo Code
202
+
203
+ Add to your Roo Code MCP settings:
109
204
 
110
205
  ```json
111
206
  {
112
207
  "mcpServers": {
113
208
  "commit-check": {
114
- "command": "/absolute/path/to/commit-check-mcp"
209
+ "command": "uvx",
210
+ "args": ["commit-check-mcp"]
211
+ }
212
+ }
213
+ }
214
+ ```
215
+
216
+ ### Zed
217
+
218
+ Add to your `~/.config/zed/settings.json`:
219
+
220
+ ```json
221
+ {
222
+ "mcp_servers": {
223
+ "commit-check": {
224
+ "command": "uvx",
225
+ "args": ["commit-check-mcp"]
115
226
  }
116
227
  }
117
228
  }
118
229
  ```
119
230
 
120
- For local development from this repository, that absolute path may point to something like `.venv/bin/commit-check-mcp`.
231
+ ### Generic / Any MCP Client
232
+
233
+ If your client does not support `uvx`, use `pip` and the direct path:
234
+
235
+ ```bash
236
+ pip install commit-check-mcp
237
+ which commit-check-mcp
238
+ ```
239
+
240
+ Then use the absolute path in your config:
241
+
242
+ ```json
243
+ {
244
+ "mcpServers": {
245
+ "commit-check": {
246
+ "command": "/path/to/commit-check-mcp"
247
+ }
248
+ }
249
+ }
250
+ ```
121
251
 
122
252
  ## Run Manually
123
253
 
124
254
  ```bash
255
+ # If installed via pip
125
256
  commit-check-mcp
257
+
258
+ # Or via uvx (no install needed)
259
+ uvx commit-check-mcp
126
260
  ```
127
261
 
128
262
  The server uses stdio transport, which is the recommended MCP default for local tool integrations.
@@ -232,3 +366,16 @@ Config precedence is:
232
366
  2. repository config loaded from `repo_path`
233
367
  3. `config_path` when explicitly provided
234
368
  4. inline `config` overrides passed to the tool
369
+
370
+ ## Published On
371
+
372
+ | Directory | Link |
373
+ |---|---|
374
+ | **Official MCP Registry** | [`io.github.commit-check/commit-check-mcp`](https://registry.modelcontextprotocol.io/) |
375
+ | **Glama.ai** | [`github/commit-check/commit-check-mcp`](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp) |
376
+ | **PyPI** | [`commit-check-mcp`](https://pypi.org/project/commit-check-mcp/) |
377
+
378
+ To also add this server to your preferred directory, open a pull request at:
379
+
380
+ - [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) — community-maintained list
381
+ - [Smithery.ai](https://smithery.ai/) — hosted MCP server registry
@@ -1,10 +1,14 @@
1
1
  # commit-check-mcp
2
2
 
3
+ mcp-name: io.github.commit-check/commit-check-mcp
4
+
3
5
  [![PyPI version](https://img.shields.io/pypi/v/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
4
6
  [![Python versions](https://img.shields.io/pypi/pyversions/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
5
7
  [![Build](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml/badge.svg)](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml)
6
8
  [![Coverage](https://codecov.io/gh/commit-check/commit-check-mcp/graph/badge.svg)](https://codecov.io/gh/commit-check/commit-check-mcp)
7
9
  [![MCP server](https://img.shields.io/badge/MCP-server-0A7B83)](https://modelcontextprotocol.io/)
10
+ [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.commit--check/commit--check--mcp-7B3F00)](https://registry.modelcontextprotocol.io/)
11
+ [![Glama](https://img.shields.io/badge/Glama-commit--check--mcp-blue)](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp)
8
12
 
9
13
  Model Context Protocol (MCP) server for [commit-check](https://github.com/commit-check/commit-check).
10
14
 
@@ -58,44 +62,174 @@ pip install -e .
58
62
 
59
63
  This server runs over stdio, so it is meant to be launched by an MCP client rather than used as a long-running HTTP service.
60
64
 
61
- Generic MCP client config:
65
+ With `uvx` (recommended — no install needed):
66
+
67
+ ```bash
68
+ # Run once, no pip install required
69
+ uvx commit-check-mcp
70
+ ```
71
+
72
+ > **Tip**: If `uv` is not installed, get it via `curl -LsSf https://astral.sh/uv/install.sh | sh`.
73
+
74
+ ---
75
+
76
+ ### Claude Desktop
62
77
 
63
78
  ```json
64
79
  {
65
80
  "mcpServers": {
66
81
  "commit-check": {
67
- "command": "commit-check-mcp"
82
+ "command": "uvx",
83
+ "args": ["commit-check-mcp"]
68
84
  }
69
85
  }
70
86
  }
71
87
  ```
72
88
 
73
- If the client needs the full path to the executable, first locate it:
89
+ ### Claude Code CLI
74
90
 
75
- ```bash
76
- which commit-check-mcp
91
+ ```json
92
+ {
93
+ "mcpServers": {
94
+ "commit-check": {
95
+ "command": "uvx",
96
+ "args": ["commit-check-mcp"]
97
+ }
98
+ }
99
+ }
100
+ ```
101
+
102
+ Add to your `~/.claude/settings.json` or project-level `.claude/settings.local.json`.
103
+
104
+ ### Cursor
105
+
106
+ In Cursor, go to **Settings → Cursor Settings → MCP → Add new MCP server** and paste:
107
+
108
+ | Field | Value |
109
+ |---|---|
110
+ | **Name** | `commit-check` |
111
+ | **Type** | `command` |
112
+ | **Command** | `uvx commit-check-mcp` |
113
+
114
+ Or add to your project's `.cursor/mcp.json`:
115
+
116
+ ```json
117
+ {
118
+ "mcpServers": {
119
+ "commit-check": {
120
+ "command": "uvx",
121
+ "args": ["commit-check-mcp"]
122
+ }
123
+ }
124
+ }
125
+ ```
126
+
127
+ ### Windsurf
128
+
129
+ Add to your `~/.codeium/windsurf/mcp_config.json`:
130
+
131
+ ```json
132
+ {
133
+ "mcpServers": {
134
+ "commit-check": {
135
+ "command": "uvx",
136
+ "args": ["commit-check-mcp"]
137
+ }
138
+ }
139
+ }
140
+ ```
141
+
142
+ ### Cline (VS Code)
143
+
144
+ Add a new MCP server in the Cline extension settings:
145
+
146
+ ```json
147
+ {
148
+ "mcpServers": {
149
+ "commit-check": {
150
+ "command": "uvx",
151
+ "args": ["commit-check-mcp"]
152
+ }
153
+ }
154
+ }
77
155
  ```
78
156
 
79
- Then use that absolute path in the client config.
157
+ ### Continue.dev (VS Code / JetBrains)
80
158
 
81
- Example using an absolute path:
159
+ Add to your `~/.continue/config.json`:
160
+
161
+ ```json
162
+ {
163
+ "experimental": {
164
+ "mcpServers": {
165
+ "commit-check": {
166
+ "command": "uvx",
167
+ "args": ["commit-check-mcp"]
168
+ }
169
+ }
170
+ }
171
+ }
172
+ ```
173
+
174
+ ### Roo Code
175
+
176
+ Add to your Roo Code MCP settings:
82
177
 
83
178
  ```json
84
179
  {
85
180
  "mcpServers": {
86
181
  "commit-check": {
87
- "command": "/absolute/path/to/commit-check-mcp"
182
+ "command": "uvx",
183
+ "args": ["commit-check-mcp"]
184
+ }
185
+ }
186
+ }
187
+ ```
188
+
189
+ ### Zed
190
+
191
+ Add to your `~/.config/zed/settings.json`:
192
+
193
+ ```json
194
+ {
195
+ "mcp_servers": {
196
+ "commit-check": {
197
+ "command": "uvx",
198
+ "args": ["commit-check-mcp"]
88
199
  }
89
200
  }
90
201
  }
91
202
  ```
92
203
 
93
- For local development from this repository, that absolute path may point to something like `.venv/bin/commit-check-mcp`.
204
+ ### Generic / Any MCP Client
205
+
206
+ If your client does not support `uvx`, use `pip` and the direct path:
207
+
208
+ ```bash
209
+ pip install commit-check-mcp
210
+ which commit-check-mcp
211
+ ```
212
+
213
+ Then use the absolute path in your config:
214
+
215
+ ```json
216
+ {
217
+ "mcpServers": {
218
+ "commit-check": {
219
+ "command": "/path/to/commit-check-mcp"
220
+ }
221
+ }
222
+ }
223
+ ```
94
224
 
95
225
  ## Run Manually
96
226
 
97
227
  ```bash
228
+ # If installed via pip
98
229
  commit-check-mcp
230
+
231
+ # Or via uvx (no install needed)
232
+ uvx commit-check-mcp
99
233
  ```
100
234
 
101
235
  The server uses stdio transport, which is the recommended MCP default for local tool integrations.
@@ -205,3 +339,16 @@ Config precedence is:
205
339
  2. repository config loaded from `repo_path`
206
340
  3. `config_path` when explicitly provided
207
341
  4. inline `config` overrides passed to the tool
342
+
343
+ ## Published On
344
+
345
+ | Directory | Link |
346
+ |---|---|
347
+ | **Official MCP Registry** | [`io.github.commit-check/commit-check-mcp`](https://registry.modelcontextprotocol.io/) |
348
+ | **Glama.ai** | [`github/commit-check/commit-check-mcp`](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp) |
349
+ | **PyPI** | [`commit-check-mcp`](https://pypi.org/project/commit-check-mcp/) |
350
+
351
+ To also add this server to your preferred directory, open a pull request at:
352
+
353
+ - [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) — community-maintained list
354
+ - [Smithery.ai](https://smithery.ai/) — hosted MCP server registry
@@ -0,0 +1,36 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.commit-check/commit-check-mcp",
4
+ "title": "commit-check MCP",
5
+ "description": "Validate commit messages, branch names, author info, push safety, and repo state.",
6
+ "version": "0.1.5",
7
+ "repository": {
8
+ "url": "https://github.com/commit-check/commit-check-mcp",
9
+ "source": "github"
10
+ },
11
+ "categories": [
12
+ "developer-tools",
13
+ "version-control"
14
+ ],
15
+ "packages": [
16
+ {
17
+ "registryType": "pypi",
18
+ "identifier": "commit-check-mcp",
19
+ "version": "0.1.5",
20
+ "transport": {
21
+ "type": "stdio",
22
+ "runtimeHint": "uvx commit-check-mcp"
23
+ }
24
+ }
25
+ ],
26
+ "tools": [
27
+ "server_health",
28
+ "validate_commit_message",
29
+ "validate_branch_name",
30
+ "validate_push_safety",
31
+ "validate_author_info",
32
+ "validate_commit_context",
33
+ "validate_repository_state",
34
+ "describe_validation_rules"
35
+ ]
36
+ }
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: commit-check-mcp
3
- Version: 0.1.4
3
+ Version: 0.1.5
4
4
  Summary: MCP server exposing commit-check validation tools
5
5
  Author-email: Xianpeng Shen <xianpeng.shen@gmail.com>
6
6
  License: MIT
@@ -27,11 +27,15 @@ Dynamic: license-file
27
27
 
28
28
  # commit-check-mcp
29
29
 
30
+ mcp-name: io.github.commit-check/commit-check-mcp
31
+
30
32
  [![PyPI version](https://img.shields.io/pypi/v/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
31
33
  [![Python versions](https://img.shields.io/pypi/pyversions/commit-check-mcp)](https://pypi.org/project/commit-check-mcp/)
32
34
  [![Build](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml/badge.svg)](https://github.com/commit-check/commit-check-mcp/actions/workflows/main.yml)
33
35
  [![Coverage](https://codecov.io/gh/commit-check/commit-check-mcp/graph/badge.svg)](https://codecov.io/gh/commit-check/commit-check-mcp)
34
36
  [![MCP server](https://img.shields.io/badge/MCP-server-0A7B83)](https://modelcontextprotocol.io/)
37
+ [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.commit--check/commit--check--mcp-7B3F00)](https://registry.modelcontextprotocol.io/)
38
+ [![Glama](https://img.shields.io/badge/Glama-commit--check--mcp-blue)](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp)
35
39
 
36
40
  Model Context Protocol (MCP) server for [commit-check](https://github.com/commit-check/commit-check).
37
41
 
@@ -85,44 +89,174 @@ pip install -e .
85
89
 
86
90
  This server runs over stdio, so it is meant to be launched by an MCP client rather than used as a long-running HTTP service.
87
91
 
88
- Generic MCP client config:
92
+ With `uvx` (recommended — no install needed):
93
+
94
+ ```bash
95
+ # Run once, no pip install required
96
+ uvx commit-check-mcp
97
+ ```
98
+
99
+ > **Tip**: If `uv` is not installed, get it via `curl -LsSf https://astral.sh/uv/install.sh | sh`.
100
+
101
+ ---
102
+
103
+ ### Claude Desktop
89
104
 
90
105
  ```json
91
106
  {
92
107
  "mcpServers": {
93
108
  "commit-check": {
94
- "command": "commit-check-mcp"
109
+ "command": "uvx",
110
+ "args": ["commit-check-mcp"]
95
111
  }
96
112
  }
97
113
  }
98
114
  ```
99
115
 
100
- If the client needs the full path to the executable, first locate it:
116
+ ### Claude Code CLI
101
117
 
102
- ```bash
103
- which commit-check-mcp
118
+ ```json
119
+ {
120
+ "mcpServers": {
121
+ "commit-check": {
122
+ "command": "uvx",
123
+ "args": ["commit-check-mcp"]
124
+ }
125
+ }
126
+ }
127
+ ```
128
+
129
+ Add to your `~/.claude/settings.json` or project-level `.claude/settings.local.json`.
130
+
131
+ ### Cursor
132
+
133
+ In Cursor, go to **Settings → Cursor Settings → MCP → Add new MCP server** and paste:
134
+
135
+ | Field | Value |
136
+ |---|---|
137
+ | **Name** | `commit-check` |
138
+ | **Type** | `command` |
139
+ | **Command** | `uvx commit-check-mcp` |
140
+
141
+ Or add to your project's `.cursor/mcp.json`:
142
+
143
+ ```json
144
+ {
145
+ "mcpServers": {
146
+ "commit-check": {
147
+ "command": "uvx",
148
+ "args": ["commit-check-mcp"]
149
+ }
150
+ }
151
+ }
152
+ ```
153
+
154
+ ### Windsurf
155
+
156
+ Add to your `~/.codeium/windsurf/mcp_config.json`:
157
+
158
+ ```json
159
+ {
160
+ "mcpServers": {
161
+ "commit-check": {
162
+ "command": "uvx",
163
+ "args": ["commit-check-mcp"]
164
+ }
165
+ }
166
+ }
167
+ ```
168
+
169
+ ### Cline (VS Code)
170
+
171
+ Add a new MCP server in the Cline extension settings:
172
+
173
+ ```json
174
+ {
175
+ "mcpServers": {
176
+ "commit-check": {
177
+ "command": "uvx",
178
+ "args": ["commit-check-mcp"]
179
+ }
180
+ }
181
+ }
104
182
  ```
105
183
 
106
- Then use that absolute path in the client config.
184
+ ### Continue.dev (VS Code / JetBrains)
107
185
 
108
- Example using an absolute path:
186
+ Add to your `~/.continue/config.json`:
187
+
188
+ ```json
189
+ {
190
+ "experimental": {
191
+ "mcpServers": {
192
+ "commit-check": {
193
+ "command": "uvx",
194
+ "args": ["commit-check-mcp"]
195
+ }
196
+ }
197
+ }
198
+ }
199
+ ```
200
+
201
+ ### Roo Code
202
+
203
+ Add to your Roo Code MCP settings:
109
204
 
110
205
  ```json
111
206
  {
112
207
  "mcpServers": {
113
208
  "commit-check": {
114
- "command": "/absolute/path/to/commit-check-mcp"
209
+ "command": "uvx",
210
+ "args": ["commit-check-mcp"]
211
+ }
212
+ }
213
+ }
214
+ ```
215
+
216
+ ### Zed
217
+
218
+ Add to your `~/.config/zed/settings.json`:
219
+
220
+ ```json
221
+ {
222
+ "mcp_servers": {
223
+ "commit-check": {
224
+ "command": "uvx",
225
+ "args": ["commit-check-mcp"]
115
226
  }
116
227
  }
117
228
  }
118
229
  ```
119
230
 
120
- For local development from this repository, that absolute path may point to something like `.venv/bin/commit-check-mcp`.
231
+ ### Generic / Any MCP Client
232
+
233
+ If your client does not support `uvx`, use `pip` and the direct path:
234
+
235
+ ```bash
236
+ pip install commit-check-mcp
237
+ which commit-check-mcp
238
+ ```
239
+
240
+ Then use the absolute path in your config:
241
+
242
+ ```json
243
+ {
244
+ "mcpServers": {
245
+ "commit-check": {
246
+ "command": "/path/to/commit-check-mcp"
247
+ }
248
+ }
249
+ }
250
+ ```
121
251
 
122
252
  ## Run Manually
123
253
 
124
254
  ```bash
255
+ # If installed via pip
125
256
  commit-check-mcp
257
+
258
+ # Or via uvx (no install needed)
259
+ uvx commit-check-mcp
126
260
  ```
127
261
 
128
262
  The server uses stdio transport, which is the recommended MCP default for local tool integrations.
@@ -232,3 +366,16 @@ Config precedence is:
232
366
  2. repository config loaded from `repo_path`
233
367
  3. `config_path` when explicitly provided
234
368
  4. inline `config` overrides passed to the tool
369
+
370
+ ## Published On
371
+
372
+ | Directory | Link |
373
+ |---|---|
374
+ | **Official MCP Registry** | [`io.github.commit-check/commit-check-mcp`](https://registry.modelcontextprotocol.io/) |
375
+ | **Glama.ai** | [`github/commit-check/commit-check-mcp`](https://glama.ai/mcp/servers/github/commit-check/commit-check-mcp) |
376
+ | **PyPI** | [`commit-check-mcp`](https://pypi.org/project/commit-check-mcp/) |
377
+
378
+ To also add this server to your preferred directory, open a pull request at:
379
+
380
+ - [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) — community-maintained list
381
+ - [Smithery.ai](https://smithery.ai/) — hosted MCP server registry
@@ -2,6 +2,7 @@
2
2
  LICENSE
3
3
  README.md
4
4
  pyproject.toml
5
+ server.json
5
6
  uv.lock
6
7
  .github/dependabot.yml
7
8
  .github/workflows/labeler.yml
@@ -15,5 +16,7 @@ src/commit_check_mcp.egg-info/SOURCES.txt
15
16
  src/commit_check_mcp.egg-info/dependency_links.txt
16
17
  src/commit_check_mcp.egg-info/entry_points.txt
17
18
  src/commit_check_mcp.egg-info/requires.txt
19
+ src/commit_check_mcp.egg-info/scm_file_list.json
20
+ src/commit_check_mcp.egg-info/scm_version.json
18
21
  src/commit_check_mcp.egg-info/top_level.txt
19
22
  tests/test_server.py
@@ -0,0 +1,18 @@
1
+ {
2
+ "files": [
3
+ "server.json",
4
+ "README.md",
5
+ "uv.lock",
6
+ "LICENSE",
7
+ "pyproject.toml",
8
+ ".gitignore",
9
+ "src/commit_check_mcp/__init__.py",
10
+ "src/commit_check_mcp/server.py",
11
+ "tests/test_server.py",
12
+ ".github/dependabot.yml",
13
+ ".github/workflows/main.yml",
14
+ ".github/workflows/labeler.yml",
15
+ ".github/workflows/release-drafter.yml",
16
+ ".github/workflows/publish.yml"
17
+ ]
18
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "tag": "0.1.5",
3
+ "distance": 0,
4
+ "node": "ge95b6c9ba730cfa7a646f21141e00ad34c25344b",
5
+ "dirty": false,
6
+ "branch": "main",
7
+ "node_date": "2026-07-02"
8
+ }