MCP Read Json

🚀 MCP 知識庫閱讀器

MCP 知識庫閱讀器是一個 MCP（模型上下文協議）服務器，用於讀取以 JSON 格式存儲的知識庫，能通過 Claude 或其他 LLM 為用戶提供所需信息。

🚀 快速開始

本項目可按以下步驟快速啟動：

安裝依賴

npm install

開發模式啟動

npm run dev

✨ 主要特性

• 可讀取結構化的 JSON 知識庫。
• 支持根據關鍵詞搜索信息。
• 能按 ID 獲取條目。
• 支持按類別和標籤篩選條目。
• 可查找相關條目。
• 能提供知識庫統計信息。
• 只讀模式：不修改 JSON 文件，僅讀取信息。

📦 安裝指南

安裝依賴

npm install

開發模式啟動

npm run dev

💻 使用示例

基礎用法

JSON 格式說明

知識庫由以下部分組成：

• metadata：包含知識庫的元數據，如標題、描述和版本信息。
• categories：定義知識庫中的類別列表。
• entries：存儲具體的條目內容，每個條目都有一個唯一的 ID 和其他屬性。

知識庫採用以下 JSON 格式：

{
  "metadata": {
    "title": "知識庫標題",
    "description": "知識庫描述",
    "version": "1.0",
    "created": "2025-04-23",
    "updated": "2025-04-23"
  },
  "categories": [
    {
      "id": "categoria1",
      "name": "類別名稱",
      "description": "類別描述"
    }
  ],
  "entries": [
    {
      "id": "entry1",
      "title": "條目標題",
      "content": "條目內容",
      "tags": ["tag1", "tag2"],
      "category": "categoria1",
      "created_at": "2023-01-01",
      "updated_at": "2023-01-01"
    }
  ]
}

高級用法

工具介紹

1. read_knowledge_base

• 功能：讀取整個知識庫的內容。
• 示例：

  // 返回所有條目及其詳細信息
  

2. search_entries

• 功能：根據關鍵詞搜索條目。
• 示例：

  search_entries("AI")
  

3. get_entry_by_id

• 功能：按 ID 獲取特定條目。
• 示例：

  get_entry_by_id("entry1")
  

4. filter_entries_by_tag

• 功能：根據標籤篩選條目。
• 示例：

  filter_entries_by_tag(["tag1", "tag2"])
  

5. get_related_entries

• 功能：獲取相關條目。
• 示例：

  get_related_entries("entry1")
  

6. knowledge_stats

• 功能：提供知識庫的統計信息，如總條目數、類別數量等。

示例提示

在與 Claude 進行交互時，可以使用以下提示：

作為 MCP 知識庫專家，你可以訪問一個結構化的 MCP 相關知識庫。請按照以下步驟操作：
1. 首先使用 `knowledge_stats` 查看知識庫的整體情況
2. 當被詢問到具體問題時，使用合適的工具（如 `search_entries` 或 `get_entry_by_id`）查找信息

在回答時：
1. 僅基於知識庫中的信息提供答案
2. 如果找不到相關信息，請明確說明
3. 使用清晰簡潔的格式呈現結果
4. 當合適時，可以建議相關主題

📚 詳細文檔

開發指南

安裝開發依賴

npm install

啟動開發模式

npm run dev

📄 許可證

本項目採用 MIT 許可證。