MindOS

Created By

GeminiLight5 days ago

Local-first knowledge base MCP server. Let AI agents (Claude, Cursor, Gemini CLI, etc.) read and write your Markdown notes via MCP protocol. Supports Streamable HTTP and stdio transports.

# knowledge-base

# mcp-server

Overview Content Tools Comments

Overview

What is MindOS?

MindOS is a local-first knowledge base that lets AI agents read and write your Markdown notes via MCP. Think of it as persistent memory for your agents — stored on your own machine, in plain Markdown files.

Quick Start

# Install and start
npm install -g @geminilight/mindos
mindos onboard   # interactive setup
mindos start     # starts app (port 3000) + MCP server (port 8787)

Then add to your agent's MCP config:

{
  "mcpServers": {
    "mindos": {
      "url": "http://localhost:8787/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

Available Tools (20)

┌─────────────────────────────┬──────────────────────────────────────┐
│            Tool             │             Description              │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_list_files           │ List all files in the knowledge base │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_read_file            │ Read file content (with pagination)  │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_write_file           │ Overwrite file content               │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_create_file          │ Create a new .md or .csv file        │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_delete_file          │ Delete a file                        │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_search_notes         │ Full-text search across all files    │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_recent           │ Get recently modified files          │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_append_to_file       │ Append content to end of file        │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_insert_after_heading │ Insert after a Markdown heading      │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_update_section       │ Replace a Markdown section           │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_backlinks        │ Find files referencing a given path  │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_bootstrap            │ Load startup context for agents      │
├─────────────────────────────┼──────────────────────────────────────┤
│ mindos_get_history          │ Get git commit history for a file    │
├─────────────────────────────┼──────────────────────────────────────┤
│ ...                         │ (20 tools total)                     │
└─────────────────────────────┴──────────────────────────────────────┘

Supported Agents

Claude Code · Cursor · Gemini CLI · Windsurf · Cline · and more

Server Config

{
  "mcpServers": {
    "mindos": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

CursorThe AI Code Editor

Playwright McpPlaywright MCP server

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

DeepChatYour AI Partner on Desktop

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.