MCP ExplorerExplorer

Local Store Mcp

@fak111on 10 months ago
4 MIT
FreeCommunity
AI Systems
ez and Valid

Overview

What is Local Store Mcp

local_store_mcp is a local knowledge management MCP server built using the FastMCP framework, designed for efficient storage and retrieval of knowledge.

Use cases

Use cases include storing programming tips, searching for specific knowledge topics, viewing knowledge base statistics, and managing knowledge records effectively.

How to use

To use local_store_mcp, install dependencies using ‘uv’, configure the Claude Desktop with the server command, and then restart Claude Desktop. You can store knowledge, search for it, and view statistics through provided tools.

Key features

Key features include smart storage with auto-generated titles and tags, powerful fuzzy search capabilities, AI-suggested smart tags, usage statistics for the knowledge base, secure storage in the user’s home directory, and thread-safe concurrent access.

Where to use

local_store_mcp can be used in various fields such as software development, education, and any domain requiring efficient knowledge management and retrieval.

Content

Project Logo

Local Store MCP

Your Data, Store Local

Demo Video

https://github.com/user-attachments/assets/4b8f11cd-bb9f-4822-b241-60ecd60bf39f

Features

  • Smart Storage: Auto-generate titles and tags
  • 🔍 Powerful Search: Support fuzzy search and tag filtering
  • 🏷️ Smart Tags: AI-suggested tags based on content
  • 📊 Statistics: Knowledge base usage statistics
  • 💾 Secure Storage: Data stored in user home directory
  • 🔒 Thread Safe: Support concurrent access

Project Structure

knowledge_vault/
├── __init__.py          # Package initialization
├── server.py            # FastMCP server main file
├── storage.py           # Knowledge storage module
└── search.py            # Search functionality module
pyproject.toml           # Project configuration
start_server_new.py      # Startup script

Installation

Install dependencies with uv

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Sync dependencies
uv sync

Configure Claude Desktop

Edit ~/.config/claude_desktop_config.json:

{
  "mcpServers": {
    "knowledge-vault": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local_store_mcp",
        "run",
        "python",
        "start_server_new.py"
      ],
      "cwd": "/path/to/your/local_store_mcp",
      "description": "Local Knowledge Management MCP Server"
    }
  }
}

Restart Claude Desktop

Restart Claude Desktop after configuration.

Usage

Store Knowledge

Store a programming tip: Using Python list comprehension makes code more concise

Search Knowledge

Search for Python knowledge

View Statistics

Show knowledge base statistics

Available Tools

  1. store_knowledge - Store knowledge records
  2. search_knowledge - Search knowledge records
  3. list_recent - View recent records
  4. get_knowledge - Get record by ID
  5. suggest_tags - Suggest tags
  6. search_by_tags - Search by tags
  7. get_stats - Get statistics

Data Storage

  • Location: ~/.knowledge-vault/knowledge.jsonl
  • Format: JSON Lines
  • Thread Safe: File locking for concurrent access

Tech Stack

  • FastMCP: MCP server framework
  • Pydantic: Data validation
  • uv: Modern Python package management
  • Python 3.10+: Runtime environment

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers