MCP Read Json

🚀 MCP Knowledge Base Reader

An MCP (Model Context Protocol) server designed to read knowledge bases stored in JSON format, enabling information provision via Claude or other LLMs.

✨ Features

• Read structured JSON knowledge bases.
• Search for information based on keywords.
• Retrieve entries by ID.
• Filter by category and tags.
• Find related entries.
• Provide statistical information about the knowledge base.
• Read-only mode: Only read information without modifying the JSON file.

📚 Knowledge Base Structure

The knowledge base uses the following JSON format:

{
  "metadata": {
    "title": "Knowledge Base Title",
    "description": "Knowledge Base Description",
    "version": "1.0",
    "created": "2025-04-23",
    "updated": "2025-04-23"
  },
  "categories": [
    {
      "id": "categoria1",
      "name": "Category Name",
      "description": "Category Description"
    }
  ],
  "entries": [
    {
      "id": "entry1",
      "title": "Entry Title",
      "content": "Entry Content",
      "tags": ["tag1", "tag2"],
      "category": "categoria1",
      "created_at": "2023-01-01",
      "updated_at": "2023-01-01"
    }
  ]
}

📦 Installation and Configuration

Install Dependencies

npm install

Start in Development Mode

npm run dev

💻 Usage Examples

JSON Format Explanation

The knowledge base consists of the following parts:

• metadata: Contains metadata about the knowledge base, such as title, description, and version information.
• categories: Defines a list of categories in the knowledge base.
• entries: Stores specific entry content, with each entry having a unique ID and other attributes.

Tool Introduction

1. read_knowledge_base

• Function: Read the entire content of the knowledge base.
• Example:

  // Return all entries and their detailed information
  

2. search_entries

• Function: Search for entries based on keywords.
• Example:

  search_entries("AI")
  

3. get_entry_by_id

• Function: Retrieve a specific entry by ID.
• Example:

  get_entry_by_id("entry1")
  

4. filter_entries_by_tag

• Function: Filter entries based on tags.
• Example:

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

5. get_related_entries

• Function: Get related entries.
• Example:

  get_related_entries("entry1")
  

6. knowledge_stats

• Function: Provide statistical information about the knowledge base, such as the total number of entries and the number of categories.

Example Prompt

When interacting with Claude, you can use the following prompt:

As an MCP knowledge base expert, you have access to a structured MCP-related knowledge base. Please follow these steps:
1. First, use `knowledge_stats` to view the overall situation of the knowledge base.
2. When asked a specific question, use appropriate tools (such as `search_entries` or `get_entry_by_id`) to find information.

When answering:
1. Provide answers based only on the information in the knowledge base.
2. If no relevant information is found, clearly state so.
3. Present the results in a clear and concise format.
4. When appropriate, suggest related topics.

🛠️ Development Guide

Install Development Dependencies

npm install

Start Development Mode

npm run dev

📄 License

MIT