Back to MCP directory
publicPublicdnsLocal runtime

zk-mcp

zk-mcp是一个MCP服务器,用于将zk管理的笔记与LLMs集成,旨在让LLMs高效访问zk管理的知识库。

article

README

🚀 zk - MCP 介绍

zk - MCP 是一个用于将由 zk 管理的知识库与大语言模型 (LLM) 集成的 MCP 服务器。其目标是让 LLM 能够高效地访问通过 zk 管理的知识库。

🚀 快速开始

🔧 先决条件

💻 使用示例

基础用法

  1. 克隆此仓库
  2. servers.json 中添加以下设置:
{
  "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/"
      }
    }
  }
}
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client