dsh-codebase-chat-mcp 0.2.2 → 0.2.3
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.
- package/README.md +83 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,19 +1,43 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-codebase-chat-mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="https://raw.githubusercontent.com/shinzarou-eng/dsh-codebase-chat/main/docs/assets/logo.svg" width="80" height="80" alt="dsh-codebase-chat logo">
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<strong>Standalone MCP server for dsh-codebase-chat.</strong><br>
|
|
9
|
+
Works with Windsurf, Cursor, Claude, and any MCP-compatible IDE — without DeepSeek Harness.
|
|
10
|
+
</p>
|
|
11
|
+
|
|
12
|
+
<p align="center">
|
|
13
|
+
<a href="https://www.npmjs.com/package/dsh-codebase-chat-mcp"><img src="https://img.shields.io/npm/v/dsh-codebase-chat-mcp?logo=npm&color=purple" alt="npm"></a>
|
|
14
|
+
<a href="https://github.com/shinzarou-eng/dsh-codebase-chat/releases"><img src="https://img.shields.io/github/v/release/shinzarou-eng/dsh-codebase-chat?logo=github" alt="release"></a>
|
|
15
|
+
<a href="../LICENSE"><img src="https://img.shields.io/github/license/shinzarou-eng/dsh-codebase-chat?color=blue" alt="license"></a>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## What it does
|
|
21
|
+
|
|
22
|
+
This package exposes the same codebase intelligence tools as the DeepSeek Harness plugin, but as a standalone **Model Context Protocol (MCP)** server. It scans a local project, builds a prompt, and calls the LLM API directly.
|
|
23
|
+
|
|
24
|
+
Your code never leaves your machine until the final prompt is sent to the LLM.
|
|
25
|
+
|
|
26
|
+
---
|
|
4
27
|
|
|
5
28
|
## Prerequisites
|
|
6
29
|
|
|
7
30
|
- Node.js >= 20
|
|
8
31
|
- A DeepSeek / OpenAI-compatible API key: `DEEPSEEK_API_KEY` or `OPENAI_API_KEY`
|
|
9
32
|
|
|
10
|
-
|
|
33
|
+
---
|
|
11
34
|
|
|
12
|
-
|
|
35
|
+
## Installation
|
|
13
36
|
|
|
14
37
|
```bash
|
|
15
38
|
npm install -g dsh-codebase-chat-mcp
|
|
16
|
-
|
|
39
|
+
|
|
40
|
+
# Or run without installing
|
|
17
41
|
npx dsh-codebase-chat-mcp
|
|
18
42
|
```
|
|
19
43
|
|
|
@@ -23,9 +47,10 @@ npx dsh-codebase-chat-mcp
|
|
|
23
47
|
git clone https://github.com/shinzarou-eng/dsh-codebase-chat.git
|
|
24
48
|
cd dsh-codebase-chat/mcp
|
|
25
49
|
pnpm install
|
|
26
|
-
pnpm link ../
|
|
27
50
|
```
|
|
28
51
|
|
|
52
|
+
---
|
|
53
|
+
|
|
29
54
|
## Configuration
|
|
30
55
|
|
|
31
56
|
Set one of:
|
|
@@ -41,10 +66,29 @@ Optional:
|
|
|
41
66
|
- `DEEPSEEK_BASE_URL` or `OPENAI_BASE_URL` (default: `https://api.deepseek.com/v1`)
|
|
42
67
|
- `CODEBASE_MODEL` (default: `deepseek-chat`)
|
|
43
68
|
|
|
69
|
+
---
|
|
70
|
+
|
|
44
71
|
## Usage in Windsurf / Cursor / Claude
|
|
45
72
|
|
|
46
73
|
Add to your MCP config:
|
|
47
74
|
|
|
75
|
+
```json
|
|
76
|
+
{
|
|
77
|
+
"mcpServers": {
|
|
78
|
+
"dsh-codebase-chat": {
|
|
79
|
+
"command": "npx",
|
|
80
|
+
"args": ["dsh-codebase-chat-mcp"],
|
|
81
|
+
"env": {
|
|
82
|
+
"DEEPSEEK_API_KEY": "sk-...",
|
|
83
|
+
"CODEBASE_MODEL": "deepseek-chat"
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
On Windows with a local clone you can also use the absolute path:
|
|
91
|
+
|
|
48
92
|
```json
|
|
49
93
|
{
|
|
50
94
|
"mcpServers": {
|
|
@@ -61,19 +105,23 @@ Add to your MCP config:
|
|
|
61
105
|
}
|
|
62
106
|
```
|
|
63
107
|
|
|
108
|
+
---
|
|
109
|
+
|
|
64
110
|
## Tools exposed
|
|
65
111
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
112
|
+
| Tool | Purpose |
|
|
113
|
+
| --- | --- |
|
|
114
|
+
| `codebase_chat` | Q&A on a local project |
|
|
115
|
+
| `codebase_search` | Search symbol or term |
|
|
116
|
+
| `codebase_explain` | Explain a file or symbol |
|
|
117
|
+
| `codebase_refactor` | Propose a refactor |
|
|
118
|
+
| `codebase_intelligence` | Full CTO brief |
|
|
119
|
+
| `codebase_audit` | Tech-debt & non-conformities |
|
|
120
|
+
| `codebase_report` | Strategic board report |
|
|
121
|
+
| `codebase_ceo` | One-page CEO brief |
|
|
122
|
+
| `codebase_tasks` | Generate a `TASKS.md` plan |
|
|
123
|
+
| `codebase_player` | UX / playthrough brief |
|
|
124
|
+
| `codebase_crea` | Creative / marketing ideas from the code |
|
|
77
125
|
|
|
78
126
|
All tools accept:
|
|
79
127
|
|
|
@@ -81,6 +129,24 @@ All tools accept:
|
|
|
81
129
|
- `lang` (string, `fr` or `en`, default: `fr`)
|
|
82
130
|
- `focus` / `query` (string, optional)
|
|
83
131
|
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Evidence & scoring
|
|
135
|
+
|
|
136
|
+
Every output is marked with:
|
|
137
|
+
|
|
138
|
+
- `[source: relative/path/file.ts:line]`
|
|
139
|
+
- `[Confidence: X%]`
|
|
140
|
+
- `[Severity: Critical/High/Medium/Low]`
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
84
144
|
## Transport
|
|
85
145
|
|
|
86
146
|
By default the server uses `stdio` (MCP standard). SSE/HTTP transport can be added in a future version.
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## License
|
|
151
|
+
|
|
152
|
+
[MIT](https://github.com/shinzarou-eng/dsh-codebase-chat/blob/main/LICENSE) — Built and maintained by [shinzarou-eng](https://github.com/shinzarou-eng).
|