MCP Knowledge Base Reader

MCP 知识库读取器

一个 MCP（Model Context Protocol）服务，可读取 JSON 格式的知识库，通过 Claude 或其他大模型向用户提供信息。

特性

• 读取结构化的 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