dsh-codebase-chat-mcp 0.2.1 → 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.
Files changed (2) hide show
  1. package/README.md +83 -17
  2. package/package.json +7 -3
package/README.md CHANGED
@@ -1,19 +1,43 @@
1
- # MCP server for dsh-codebase-chat
1
+ # dsh-codebase-chat-mcp
2
2
 
3
- Standalone MCP server for `dsh-codebase-chat`. It does **not** require DeepSeek Harness. It scans local projects and calls an LLM API directly.
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
- ## Installation
33
+ ---
11
34
 
12
- ### From npm (when published)
35
+ ## Installation
13
36
 
14
37
  ```bash
15
38
  npm install -g dsh-codebase-chat-mcp
16
- # or run without installing
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
- - `codebase_chat` — Q&A on a local project
67
- - `codebase_search` — search symbol/term
68
- - `codebase_explain` — explain a file or symbol
69
- - `codebase_refactor` — propose a refactor
70
- - `codebase_intelligence` — full CTO brief
71
- - `codebase_audit` — tech-debt & non-conformities
72
- - `codebase_report` — strategic board report
73
- - `codebase_ceo` — one-page CEO brief
74
- - `codebase_tasks` — generate a TASKS.md plan
75
- - `codebase_player` — UX / playthrough brief
76
- - `codebase_crea` — creative / marketing ideas from the code
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).
package/package.json CHANGED
@@ -1,13 +1,17 @@
1
1
  {
2
2
  "name": "dsh-codebase-chat-mcp",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "Standalone MCP server for dsh-codebase-chat. Works without DeepSeek Harness.",
5
5
  "author": "shinzarou-eng",
6
6
  "type": "module",
7
7
  "bin": {
8
- "dsh-codebase-chat-mcp": "./index.mjs"
8
+ "dsh-codebase-chat-mcp": "index.mjs"
9
+ },
10
+ "main": "index.mjs",
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "git+https://github.com/shinzarou-eng/dsh-codebase-chat.git"
9
14
  },
10
- "main": "./index.mjs",
11
15
  "scripts": {
12
16
  "start": "node index.mjs",
13
17
  "test": "node test.mjs"