MCP Knowledge Base Reader

MCP ナレッジベースリーダー

Claude やその他の LLM を通じてユーザーに情報を提供するために、JSON 形式のナレッジベースを読み取る MCP（Model Context Protocol）サーバーです。

特徴

• 構造化された JSON ナレッジベースの読み取り
• キーワードによる情報検索
• ID によるエントリーの取得
• カテゴリとタグによる絞り込み
• 関連エントリーの検索
• ナレッジベースに関する統計情報
• 読み取り専用モード：JSON ファイルを変更せず、情報の取得のみを行います

ナレッジベースの構造

ナレッジベースでは、以下の JSON 形式を使用します。

{
  "metadata": {
    "title": "Título de la Base de Conocimientos",
    "description": "Descripción de la base",
    "version": "1.0",
    "created": "2025-04-23",
    "updated": "2025-04-23"
  },
  "categories": [
    {
      "id": "categoria1",
      "name": "Nombre de Categoría",
      "description": "Descripción de la categoría"
    }
  ],
  "entries": [
    {
      "id": "entrada1",
      "title": "Título de la Entrada",
      "category": "categoria1",
      "tags": ["etiqueta1", "etiqueta2"],
      "content": "Contenido detallado de la entrada",
      "related": ["entrada2", "entrada3"]
    }
  ]
}

インストールと設定

前提条件

• Node.js 18 以降
• npm または yarn

インストール

# Clonar el repositorio
git clone https://github.com/tu-usuario/mcp-read-json.git
cd mcp-read-json

# Instalar dependencias
npm install

# Compilar el código TypeScript
npm run build

Claude Desktop の設定

このサーバーを Claude Desktop で使用するには、以下の設定を claude_desktop_config.json ファイルに追加します。

{
  "mcpServers": {
    "knowledge-reader": {
      "command": "node",
      "args": [
        "/ruta/completa/a/mcp-read-json/dist/index.js"
      ],
      "env": {
        "KNOWLEDGE_BASE_PATH": "/ruta/completa/a/tu/knowledge_base.json"
      }
    }
  }
}

設定に関する重要な注意事項：

1. スクリプトと JSON ファイルの両方に絶対パスを使用してください
2. 指定したパスに JSON ファイルが存在することを確認してください
3. 使用する前にサーバーをビルドする必要があります（npm run build）

よくある問題の解決方法

「Server disconnected」エラーが発生した場合は、以下を確認してください。

1. パスが絶対パスであり、正しいこと
2. コンパイル済みの JavaScript ファイルが指定したパスに存在すること
3. ファイルを実行する権限があること

利用可能なツール

サーバーは以下の MCP ツールを公開しています。

1. read_knowledge_base

ナレッジベース全体を読み取ります。

Claude での使用例：

Claude, usa la herramienta read_knowledge_base para mostrarme toda la información disponible en la base de conocimientos.

2. search_entries

タイトル、内容、タグのテキストからエントリーを検索します。

Claude での使用例：

Claude, utiliza search_entries para buscar información sobre "seguridad".

3. get_entry_by_id

ID を指定して、特定のエントリーを取得します。

Claude での使用例：

Claude, usa get_entry_by_id con el ID "mcp-definition" para mostrarme la definición de MCP.

4. get_entries_by_category

指定したカテゴリのエントリーをすべて取得します。

Claude での使用例：

Claude, utiliza get_entries_by_category con la categoría "intro" para mostrarme las introducciones a MCP.

5. get_entries_by_tags

指定したタグを含むエントリーを取得します。

Claude での使用例：

Claude, usa get_entries_by_tags para encontrar entradas con las etiquetas ["implementación", "código"].

6. get_related_entries

特定のエントリーに関連するエントリーを検索します。

Claude での使用例：

Claude, después de revisar la entrada "mcp-components", usa get_related_entries con el ID "mcp-components" para mostrarme temas relacionados.

7. get_knowledge_stats

ナレッジベースに関する統計情報を提供します。

Claude での使用例：

Claude, utiliza get_knowledge_stats para darme un resumen estadístico de la base de conocimientos.

Claude 用プロンプトの例

ナレッジベースを最大限に活用するには、以下のプロンプトを使用できます。

Eres un asistente especializado que tiene acceso a una base de conocimientos sobre MCP (Model Context Protocol). Utiliza las herramientas disponibles para proporcionar información precisa y relevante.

Al inicio de cada conversación, deberías:
1. Usar get_knowledge_stats para familiarizarte con la estructura y contenido de la base de conocimientos
2. Cuando te pregunten sobre un tema específico, usar search_entries o la herramienta más apropiada

Cuando respondas:
1. Basa tu respuesta solo en la información de la base de conocimientos
2. Si la información solicitada no está disponible, indícalo claramente
3. Utiliza un formato claro y estructurado en tus respuestas
4. Sugiere información relacionada cuando sea relevante

開発

# Instalar dependencias de desarrollo
npm install

# Iniciar modo desarrollo (compilación en tiempo real)
npm run dev

ライセンス

MIT