Zk MCP
zk - mcp is an MCP server used to integrate zk - managed notes with LLMs, aiming to enable LLMs to efficiently access the knowledge base managed by zk.
2 points
8.0K

What is zk-mcp?

zk-mcp is a Model Context Protocol (MCP) server specifically designed to connect the plain text note system managed by the zk tool with large language models (LLMs). It acts as middleware, allowing LLMs to efficiently query and utilize the knowledge in the zk note library.

How to use zk-mcp?

By configuring the MCP client to connect to the zk-mcp server, LLM applications can access the content in the zk note library. The zk note tool needs to be pre - installed and the note directory set up.

Applicable scenarios

Suitable for scenarios where personal or team knowledge bases need to be integrated with AI assistants, such as intelligent note retrieval, knowledge Q&A, and content generation. Particularly suitable for technical teams or individuals who already use zk to manage notes.

Main Features

Get note content
Get the full content of the specified note through the get_note command
List note paths
Get a list of paths for all notes through the get_note_paths command
Find related notes
Find other notes associated with the specified note through the get_linking_notes command
Tag management
Get all available tags or tags for a specific note through the get_tags command
Advantages
A lightweight solution optimized for the zk note system
Supports multiple note query methods to meet different usage scenarios
Easy to integrate into existing LLM applications
Open - source and customizable
Limitations
Only supports the note system managed by zk
Requires the pre - installation of the zk tool
Currently, the functions are relatively basic, and advanced search functions are limited

How to Use

Install dependencies
Ensure that the zk note tool and the uv tool are installed
Clone the repository
Get the zk - mcp server code
Configure the MCP client
Add the zk - mcp server configuration to the servers.json of the MCP client
Start the server
Start the zk - mcp server through the MCP client

Usage Examples

Intelligent note retrieval
The LLM application queries user notes through zk - mcp and answers relevant questions
Knowledge graph construction
Build a personal knowledge graph by querying the association relationships between notes
Content generation assistance
The LLM generates text that conforms more to the personal knowledge system based on the user's note content

Frequently Asked Questions

Which MCP clients does zk - mcp support?
How to ensure the security of note content?
Does zk - mcp support real - time updates?
Does it support searching note content?

Related Resources

zk official documentation
The user manual for the zk note tool
uv tool documentation
The installation and usage guide for the uv tool
MCP protocol description
The official specification of the Model Context Protocol
zk - mcp source code repository
The source code and issue tracking for zk - mcp

Installation

Copy the following command to your Client for configuration
{
  "mcpServers": {
    "zk": {
      "alwaysAllow": [
        "get_note",
        "get_note_paths",
        "get_linking_notes",
        "get_tags"
      ],
      "args": [
        "--directory",
        "/path/to/github.com/koei-kaji/zk-mcp/",
        "run",
        "server.py"
      ],
      "command": "uv",
      "env": {
        "ZK_DIR": "/path/to/zk-note-directory/"
      }
    }
  }
}
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

A
Airweave
Airweave is an open - source context retrieval layer for AI agents and RAG systems. It connects and synchronizes data from various applications, tools, and databases, and provides relevant, real - time, multi - source contextual information to AI agents through a unified search interface.
Python
6.1K
5 points
V
Vestige
Vestige is an AI memory engine based on cognitive science. By implementing 29 neuroscience modules such as prediction error gating, FSRS - 6 spaced repetition, and memory dreaming, it provides long - term memory capabilities for AI. It includes a 3D visualization dashboard and 21 MCP tools, runs completely locally, and does not require the cloud.
Rust
5.9K
4.5 points
M
Moltbrain
MoltBrain is a long-term memory layer plugin designed for OpenClaw, MoltBook, and Claude Code, capable of automatically learning and recalling project context, providing intelligent search, observation recording, analysis statistics, and persistent storage functions.
TypeScript
5.4K
4.5 points
B
Bm.md
A feature-rich Markdown typesetting tool that supports multiple style themes and platform adaptation, providing real-time editing preview, image export, and API integration capabilities
TypeScript
4.9K
5 points
H
Haiku.rag
Haiku RAG is an intelligent retrieval - augmented generation system built on LanceDB, Pydantic AI, and Docling. It supports hybrid search, re - ranking, Q&A agents, multi - agent research processes, and provides local - first document processing and MCP server integration.
Python
9.3K
5 points
C
Cipher
Cipher is an open-source memory layer framework designed for programming AI agents. It integrates with various IDEs and AI coding assistants through the MCP protocol, providing core functions such as automatic memory generation, team memory sharing, and dual-system memory management.
TypeScript
0
5 points
A
Apple Notes MCP
A server that provides local Apple Notes database access for the Claude desktop client, supporting reading and searching of note content.
Python
13.6K
4.3 points
M
MCP Server Weread
The WeRead MCP Server is a lightweight service that bridges WeRead data and AI clients, enabling in - depth interaction between reading notes and AI.
TypeScript
15.3K
4 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
21.5K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
34.5K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
24.7K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
72.5K
4.3 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
32.3K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
65.6K
4.5 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
21.1K
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
97.5K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2026AIBase