@jingjingbox/mcp-cli-bridge

MCP-CLI-Bridge-Server – Ruft CLI-Tools über das MCP-Protokoll auf und stellt KI-Assistenten leistungsstarke Funktionen für Wissensgraphen und Dateizugriffe bereit.

Einführung

@jingjingbox/mcp-cli-bridge ist ein auf dem Model Context Protocol (MCP) basierender Bridge-Server, der die Fähigkeiten von CLI-Tools über das MCP-Protokoll für KI-Assistenten (wie TraeCN) verfügbar macht.

Kernfunktionen

• Wissensgraphen-Verwaltung: Erstellen von Entitäten, Aufbau von Beziehungen, Suche nach Knoten – für den Aufbau eines vollständigen Wissensnetzwerks.

• Dateizugriff: Effizientes Lesen von Dateianfängen oder -enden, mit Unterstützung für große Dateien.

• Prozessisolation: CLI-Plugins laufen in separaten Prozessen, sodass Abstürze den Hauptdienst nicht beeinträchtigen.

• NativeAOT-Kompilierung: Maximale Performance, extrem geringe Größe, schneller Start.

• Progressives Laden: Tools werden bei Bedarf geladen und belegen keinen Kontextspeicher.

Related MCP server: mcp_server_for_claudes_toolbox

Systemanforderungen

• Betriebssystem: Windows x64

• Node.js: >= 14.0.0

• Laufzeitumgebung: .NET 10.0 Runtime (im Paket enthalten)

Installation

Globale Installation

npm install -g @jingjingbox/mcp-cli-bridge

Verwendung von npx (empfohlen)

Keine Installation erforderlich, einfach ausführen:

npx @jingjingbox/mcp-cli-bridge

Konfiguration

Umgebungsvariablen

Die Datendateien werden automatisch erstellt:

• memory.jsonl - Entitätsdaten

• memory_relations.jsonl - Beziehungsdaten

TraeCN-Konfigurationsbeispiel

Fügen Sie dies zur MCP-Konfiguration von TraeCN hinzu:

{
  "mcpServers": {
    "cli-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": ["@jingjingbox/mcp-cli-bridge"],
      "enabled": true,
      "env": {
        "MCP_MEMORY_PATH": "D:\\MCP\\Memory"
      }
    }
  }
}

Konfiguration für globale Installation

{
  "mcpServers": {
    "cli-bridge": {
      "type": "stdio",
      "command": "mcp-cli-bridge",
      "enabled": true,
      "env": {
        "MCP_MEMORY_PATH": "D:\\MCP\\Memory"
      }
    }
  }
}

Tool-Liste

Host-Ebene Tools (direkt verfügbar)

MemoryCli-Tools (Wissensgraph)

Aufruf über tool_execute, Befehlspräfix ist memory_:

FileReaderCli-Tools (Dateizugriff)

Aufruf über tool_execute, Befehlspräfix ist file_reader_:

Anwendungsbeispiele

Wissensentitäten erstellen

{
  "command": "memory_create_entities",
  "entities": [
    {
      "name": "React",
      "entityType": "Framework",
      "observations": ["用于构建用户界面的 JavaScript 库", "由 Meta 维护"]
    },
    {
      "name": "TypeScript",
      "entityType": "Language",
      "observations": ["JavaScript 的超集", "添加了静态类型检查"]
    }
  ]
}

Entitätsbeziehungen aufbauen

{
  "command": "memory_create_relations",
  "relations": [
    {
      "from": "React",
      "to": "TypeScript",
      "relationType": "supports"
    }
  ]
}

Wissensknoten suchen

{
  "command": "memory_search_nodes",
  "query": "React"
}

Dateianfang lesen

{
  "command": "file_reader_read_head",
  "filePath": "C:\\project\\logs\\app.log",
  "lineCount": 20
}

Dateiende lesen

{
  "command": "file_reader_read_tail",
  "filePath": "C:\\project\\logs\\error.log",
  "lineCount": 50
}

Architekturdesign

McpHost/
├── McpHost.exe          # MCP 主机服务
├── MemoryCli.exe        # 知识图谱 CLI 插件
├── FileReaderCli.exe    # 文件读取 CLI 插件
└── index.js             # npm 入口文件

• McpHost: MCP-Protokollserver, verantwortlich für die Bereitstellung von Tools und die Verwaltung von CLI-Prozessen.

• MemoryCli: Wissensgraphen-Verwaltung, unterstützt CRUD für Entitäten, Beziehungen und Beobachtungsdatensätze.

• FileReaderCli: Effizientes Dateilesen, unterstützt das Lesen von Anfängen/Enden großer Dateien.

Technologiestack

• .NET 10.0 - Laufzeitplattform

• NativeAOT - Native Kompilierung für maximale Performance

• C# 13 - Programmiersprache

• JSON-RPC 2.0 - CLI-Kommunikationsprotokoll

• MCP Protocol - Kommunikationsprotokoll für KI-Assistenten

Entwicklung

Quellcode-Repository

git clone https://gitee.com/JJbox/memory.git

Build

# 使用 PowerShell
.\build.ps1

Testen

# 单元测试
dotnet test McpHost.slnx

# E2E 测试
dotnet run --project tests\E2E\MyMemoryServer.E2E.csproj -c Release

Detaillierte Dokumentation

• MemoryCli-Anleitung - Vollständige API-Dokumentation für den Wissensgraphen

• FileReaderCli-Anleitung - Vollständige API-Dokumentation für das Dateilesen

Lizenz

MIT

Autor

JJbox

• Repository: https://gitee.com/JJbox/memory

• Feedback: https://gitee.com/JJbox/memory/issues