English Français العربية

io.github.KiMiGuel/claude-desktop-bridge

السجل الرسمي أدوات المطورين

Shared local knowledge vault MCP server for Claude Desktop (Chat + Code)

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package claude-desktop-bridge
Claude Code 
claude mcp add claude-desktop-bridge -e 'VAULT_DIR=<VAULT_DIR>' -- npx -y claude-desktop-bridge@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "claude-desktop-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "claude-desktop-bridge@1.0.0"
            ],
            "env": {
                "VAULT_DIR": "<VAULT_DIR>"
            }
        }
    }
}

متغيرات البيئة

  • VAULT_DIR Directory for the local SQLite vault database (defaults to ~/.claude-bridge)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Claude-Desktop-Bridge
  2. Install
  3. Tools
  4. Use it
  5. Where this works
  6. Building from source
  7. Configuration
  8. Contribute
  9. License

Claude-Desktop-Bridge

Local MCP server that gives Claude Desktop's Chat and Code tabs a shared, persistent note vault. Claude pulls only what it needs via five tools — save_note, get_notes, search_notes, update_note, delete_note — instead of re-deriving context after every tab switch.

Install

  1. Download claude-desktop-bridge.mcpb from Releases.
  2. Drag it onto the Claude Desktop window — or Settings → Extensions → Advanced settings → Install Extension…
  3. No configuration. The vault lives at ~/.claude-bridge/vault.db.

Tools

ToolDescription
save_noteSave a new note (title, content, optional tags, optional project)
get_notesRetrieve notes by id, tags, or project, most recent first
search_notesFull-text search over note titles and content
update_noteUpdate an existing note's title, content, tags, or project
delete_notePermanently delete a note by id

Notes carry an optional project field, so work across multiple codebases stays separated — each project's notes filter independently.

Use it

Talk normally in either tab — Claude calls the tools on its own when useful. You never invoke anything manually.

  • Proactive, not automatic-automatic. Claude decides what's worth saving or searching — it's not logging every message. Say "remember this for later" when you want something kept.
  • Tag by project when working across codebases, so a search in one repo's context doesn't surface another's notes.
  • Chat tab "Projects" don't auto-link to a Code tab folder. Put it in that Project's Custom Instructions: "This project corresponds to the my-repo codebase; use Claude-Desktop-Bridge with project: 'my-repo'."

Where this works

SurfaceWorks out of the box?
Claude Desktop — Chat tab✅ Yes
Claude Desktop — Code tab (local sessions)✅ Yes
Standalone claude CLI (terminal, Desktop not required)⚠️ Needs one extra step
Claude Code on the Web / cloud sessions❌ Not available (local-only server)

The standalone CLI doesn't read Desktop's extension config. Register it explicitly:

# macOS or WSL — imports every MCP server Desktop has configured
claude mcp add-from-claude-desktop

# Any platform, including Linux — register this repo's built server:
claude mcp add --scope user claude-desktop-bridge -- node /path/to/claude-desktop-bridge/server/index.js

--scope user makes it available in every terminal project. It reads the same ~/.claude-bridge/vault.db as the Desktop extension, so notes are shared.

Want notes to cost fewer tokens? cdb-companion compresses content before it hits save_note/update_note.

Building from source

npm install
npm run build   # bundles src/index.ts -> server/index.js
npm run pack     # produces claude-desktop-bridge.mcpb

Requires Node.js 22+ (built-in node:sqlite). Claude Desktop's own Node runtime runs the extension — end users need no Node install. Gates: npm ci + npm test (see .github/workflows/npm-project.yml).

Configuration

  • Vault → ~/.claude-bridge/vault.db (local SQLite). Uninstalling the extension keeps the file; notes persist until deleted via delete_note or by removing the file.
  • Network → none. No server component, no outbound requests, no analytics or telemetry.

Contribute

Open an issue to discuss before a PR. Edit src/index.ts — server/index.js is generated. PRs must pass npm ci + npm test.

License

MIT

الأسئلة الشائعة

ما هو io.github.KiMiGuel/claude-desktop-bridge؟

Shared local knowledge vault MCP server for Claude Desktop (Chat + Code)

كيف أثبّت io.github.KiMiGuel/claude-desktop-bridge؟

يعمل على جهازك. في Claude Code: claude mcp add claude-desktop-bridge -e 'VAULT_DIR=<VAULT_DIR>' -- npx -y claude-desktop-bridge@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.KiMiGuel/claude-desktop-bridge إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.KiMiGuel/claude-desktop-bridge مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.KiMiGuel/claude-desktop-bridge؟

ينشره KiMiGuel. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.