dsh-codebase-chat-mcp 0.2.1

package/README.md

@@ -0,0 +1,86 @@
+# MCP server for dsh-codebase-chat
+
+Standalone MCP server for `dsh-codebase-chat`. It does **not** require DeepSeek Harness. It scans local projects and calls an LLM API directly.
+
+## Prerequisites
+
+- Node.js >= 20
+- A DeepSeek / OpenAI-compatible API key: `DEEPSEEK_API_KEY` or `OPENAI_API_KEY`
+
+## Installation
+
+### From npm (when published)
+
+```bash
+npm install -g dsh-codebase-chat-mcp
+# or run without installing
+npx dsh-codebase-chat-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/shinzarou-eng/dsh-codebase-chat.git
+cd dsh-codebase-chat/mcp
+pnpm install
+pnpm link ../
+```
+
+## Configuration
+
+Set one of:
+
+```powershell
+$env:DEEPSEEK_API_KEY = "sk-..."
+# or
+$env:OPENAI_API_KEY = "sk-..."
+```
+
+Optional:
+
+- `DEEPSEEK_BASE_URL` or `OPENAI_BASE_URL` (default: `https://api.deepseek.com/v1`)
+- `CODEBASE_MODEL` (default: `deepseek-chat`)
+
+## Usage in Windsurf / Cursor / Claude
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "dsh-codebase-chat": {
+      "command": "node",
+      "args": [
+        "C:\\Users\\YOU\\dsh-codebase-chat\\mcp\\index.mjs"
+      ],
+      "env": {
+        "DEEPSEEK_API_KEY": "sk-..."
+      }
+    }
+  }
+}
+```
+
+## Tools exposed
+
+- `codebase_chat` — Q&A on a local project
+- `codebase_search` — search symbol/term
+- `codebase_explain` — explain a file or symbol
+- `codebase_refactor` — propose a refactor
+- `codebase_intelligence` — full CTO brief
+- `codebase_audit` — tech-debt & non-conformities
+- `codebase_report` — strategic board report
+- `codebase_ceo` — one-page CEO brief
+- `codebase_tasks` — generate a TASKS.md plan
+- `codebase_player` — UX / playthrough brief
+- `codebase_crea` — creative / marketing ideas from the code
+
+All tools accept:
+
+- `projectPath` (string, absolute or relative path, default: cwd)
+- `lang` (string, `fr` or `en`, default: `fr`)
+- `focus` / `query` (string, optional)
+
+## Transport
+
+By default the server uses `stdio` (MCP standard). SSE/HTTP transport can be added in a future version.

package/index.mjs

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import {
+  collectIntelligenceContext,
+  collectAssessmentContext,
+  collectNonConformities,
+  collectCeoContext,
+  collectTasksContext,
+  collectCodebaseContext,
+  buildIntelligencePrompt,
+  buildReportPrompt,
+  buildAuditPrompt,
+  buildCeoPrompt,
+  buildTasksPrompt,
+  buildPlayerPrompt,
+  buildSearchPrompt,
+  buildExplainPrompt,
+  buildRefactorPrompt,
+  buildChatPrompt,
+  buildCreaPrompt,
+  resolveProjectPath,
+  getProjectName,
+  normalizeLabels,
+} from "dsh-codebase-chat";
+
+const VERSION = "0.2.0";
+
+const apiKey = process.env.DEEPSEEK_API_KEY || process.env.OPENAI_API_KEY || "";
+const baseUrl = process.env.DEEPSEEK_BASE_URL || process.env.OPENAI_BASE_URL || "https://api.deepseek.com/v1";
+const model = process.env.CODEBASE_MODEL || "deepseek-chat";
+
+async function callLlm(prompt, lang = "fr") {
+  if (!apiKey) {
+    throw new Error("Aucune clef API : definissez DEEPSEEK_API_KEY ou OPENAI_API_KEY");
+  }
+  const res = await fetch(`${baseUrl}/chat/completions`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${apiKey}`,
+    },
+    body: JSON.stringify({
+      model,
+      messages: [
+        { role: "system", content: lang === "en" ? "You are a senior codebase analyst. Be precise and cite files." : "Tu es un analyste codebase senior. Sois precis et cite les fichiers." },
+        { role: "user", content: prompt },
+      ],
+      temperature: 0.3,
+      max_tokens: 8192,
+    }),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`API error ${res.status}: ${text}`);
+  }
+  const data = await res.json();
+  return data.choices?.[0]?.message?.content || "";
+}
+
+function langHint(lang) {
+  return lang === "en" ? "Respond strictly in English." : "Reponds obligatoirement en francais.";
+}
+
+function getProjectPath(projectPath) {
+  return projectPath ? String(projectPath).trim() : process.cwd();
+}
+
+function wrapPrompt(prompt, lang) {
+  const hint = langHint(lang);
+  const final = lang === "en"
+    ? "\n\n---\n\nFINAL INSTRUCTION (overrides everything above): The entire response, including section titles, bullet points and conclusion, MUST be written in English. Do not output any French words except in quoted code or file paths."
+    : "\n\n---\n\nINSTRUCTION FINALE (prime sur tout le reste): La reponse entiere, titres de sections inclus, DOIT etre en francais. Ne produis aucun mot anglais sauf dans du code ou des chemins de fichiers cites.";
+  return `${hint}\n\n${normalizeLabels(prompt, lang)}${final}`;
+}
+
+async function buildPrompt(name, args) {
+  const lang = (args.lang || "fr").toLowerCase();
+  const raw = getProjectPath(args.projectPath);
+  const projectPath = await resolveProjectPath(raw);
+  const focus = (args.focus || args.query || "").trim();
+  const style = (args.style || "punchy").toLowerCase();
+  const filePath = (args.filePath || "").trim();
+  const projectName = await getProjectName(projectPath);
+
+  let prompt = "";
+
+  switch (name) {
+    case "codebase_intelligence": {
+      const { context } = await collectIntelligenceContext(projectPath, focus, lang);
+      prompt = buildIntelligencePrompt(context, projectName, focus, style, lang);
+      break;
+    }
+    case "codebase_report": {
+      const { context } = await collectAssessmentContext(projectPath, focus, lang);
+      prompt = buildReportPrompt(context, projectName, focus, style, lang);
+      break;
+    }
+    case "codebase_audit": {
+      const { context } = await collectNonConformities(projectPath, focus, lang);
+      prompt = buildAuditPrompt(context, projectName, focus, lang);
+      break;
+    }
+    case "codebase_ceo": {
+      const { context } = await collectCeoContext(projectPath, focus || "one page executive brief", lang);
+      prompt = buildCeoPrompt(context, projectName, focus, lang);
+      break;
+    }
+    case "codebase_tasks": {
+      const { context } = await collectTasksContext(projectPath, focus || "plan d'action", lang);
+      prompt = buildTasksPrompt(context, projectName, focus, style, lang);
+      break;
+    }
+    case "codebase_player": {
+      const { context } = await collectCodebaseContext(projectPath, { focus: focus || "user journey and playthrough", lang });
+      prompt = buildPlayerPrompt(context, projectName, focus, lang);
+      break;
+    }
+    case "codebase_search": {
+      const { context } = await collectCodebaseContext(projectPath, { searchQuery: focus, lang });
+      prompt = buildSearchPrompt(focus, context, projectName, false, "", lang);
+      break;
+    }
+    case "codebase_explain": {
+      const target = filePath || focus;
+      const { context } = await collectCodebaseContext(projectPath, { focus: target, lang });
+      prompt = buildExplainPrompt(target, context, projectName, false, "", lang);
+      break;
+    }
+    case "codebase_refactor": {
+      const target = filePath || focus;
+      const { context } = await collectCodebaseContext(projectPath, { focus: target, filePath, lang });
+      prompt = buildRefactorPrompt(filePath, focus, context, projectName, false, "", lang);
+      break;
+    }
+    case "codebase_chat": {
+      const { context } = await collectCodebaseContext(projectPath, { focus, lang });
+      prompt = buildChatPrompt(focus, context, projectName, false, "", lang);
+      break;
+    }
+    case "codebase_crea": {
+      const { context } = await collectCodebaseContext(projectPath, { focus, lang });
+      prompt = buildCreaPrompt(focus, context, projectName, lang);
+      break;
+    }
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+
+  return { prompt: wrapPrompt(prompt, lang), projectName };
+}
+
+const server = new Server(
+  { name: "dsh-codebase-chat-mcp", version: VERSION },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      { name: "codebase_intelligence", description: "Pro technical audit: architecture, tech debt, opportunities and creative ideas.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, style: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_report", description: "Strategic board report with SWOT, scorecards and 90-day roadmap.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, style: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_audit", description: "Non-conformities and technical-debt audit with concrete fixes.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_tasks", description: "Generate a prioritized TASKS.md with sprints and Before/After.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, style: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_ceo", description: "One-page executive brief with metrics, risks and killer moves.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_player", description: "User journey and playthrough UX analysis.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_search", description: "Search files and symbols by term or pattern.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, query: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } }, required: ["query"] } },
+      { name: "codebase_explain", description: "Explain how a file or symbol works.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, filePath: { type: "string" }, query: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_refactor", description: "Propose a refactor for a file or function.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, filePath: { type: "string" }, query: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+      { name: "codebase_chat", description: "Open Q/A on the codebase.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, query: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } }, required: ["query"] } },
+      { name: "codebase_crea", description: "Generate creative ideas, slogans or marketing concepts from the code.", inputSchema: { type: "object", properties: { projectPath: { type: "string" }, focus: { type: "string" }, lang: { type: "string", enum: ["fr", "en"] } } } },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  try {
+    const { prompt } = await buildPrompt(name, args);
+    const content = await callLlm(prompt, args.lang);
+    return { content: [{ type: "text", text: content }] };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "dsh-codebase-chat-mcp",
+  "version": "0.2.1",
+  "description": "Standalone MCP server for dsh-codebase-chat. Works without DeepSeek Harness.",
+  "author": "shinzarou-eng",
+  "type": "module",
+  "bin": {
+    "dsh-codebase-chat-mcp": "./index.mjs"
+  },
+  "main": "./index.mjs",
+  "scripts": {
+    "start": "node index.mjs",
+    "test": "node test.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md",
+    "package.json"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "dsh-codebase-chat": "^0.16.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}