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
7.2K

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

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
12.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
13.2K
4 points
M
MCP Notion Server
Certified
The Notion MCP Server is a middleware service that connects the Notion API with the LLM, optimizing interaction efficiency through Markdown conversion.
TypeScript
14.0K
5 points
M
MCP Obsidian
This project is an MCP server used to interact with the Obsidian note application through the Local REST API plugin of Obsidian. It provides various tools to operate and manage files in Obsidian, including listing files, retrieving file content, searching, modifying content, and deleting files.
Python
13.9K
5 points
M
MCP Atlassian
MCP Atlassian is a Model Context Protocol server designed for Atlassian products (Confluence and Jira), supporting both cloud and on-premises deployments and providing AI assistant integration functions.
Python
13.2K
5 points
M
MCP Logseq Server
An MCP server for interacting with the LogSeq note-taking app, providing various API tools to operate on note content.
Python
16.0K
4.1 points
S
Solana Docs MCP Server
A TypeScript-based MCP server that implements a simple note system and supports note creation and summarization functions
TypeScript
11.2K
4.2 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
14.8K
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
24.8K
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
15.6K
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
44.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#
20.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
45.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
15.0K
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
63.1K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase