返回 MCP 目录
public公开dns本地运行

notepm-mcp-server

NotePM MCP服务器是一个用于搜索NotePM内容的服务,支持全文检索、标题搜索、标签筛选等功能,可通过MCP兼容客户端访问。

article

README

🚀 NotePM MCP 服务器

NotePM MCP 服务器可通过 Model Context Protocol (MCP) 搜索 NotePM 内容。借助该服务器,用户能使用 MCP 兼容客户端访问 NotePM 的搜索功能。

🚀 快速开始

必要条件

  • Python 3.12 或更高版本
  • NotePM 账户和 API Token
  • uv

安装

uv sync

环境配置

需要设置以下环境变量:

  • NOTEPM_TEAM:NotePM 团队名称
  • NOTEPM_API_TOKEN:NotePM API 令牌

您也可以创建 .env 文件并进行配置:

NOTEPM_TEAM=your-team-name
NOTEPM_API_TOKEN=your-api-token

启动服务器

uv run notepm-mcp-server

MCP 客户端配置

"servers": {
  "notepm-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/<路径到 mcp-servers>/notepm-mcp-server",
      "run",
      "notepm-mcp-server"
    ],
    "env": {
      "NOTEPM_TEAM": "your-team-name",
      "NOTEPM_API_TOKEN": "your-api-token"
    }
  }
}

✨ 主要特性

  • 全文搜索 NotePM 内容
  • 标题仅搜索
  • 标签搜索
  • 笔记代码搜索
  • 存档页面搜索选项
  • 分页支持
  • 获取详细文章内容
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端