印象笔记 MCP Server

基于印象笔记 Developer API 构建的 MCP (Model Context Protocol) Server，让 Claude 能够直接操作你的印象笔记账户。

功能

Related MCP server: Evernote MCP Server

快速开始

第一步：获取 Developer Token

1. 访问 https://app.yinxiang.com/api/DeveloperToken.action

2. 点击 "Create a developer token"

3. 复制以 S=s1: 开头的 Token，填入 .env 文件

第二步：安装依赖

cd ~/mcp-servers/yinxiang-mcp
uv venv --python 3.11
uv pip install -r requirements.txt

第三步：启动 HTTP Server

./start.sh       # 后台启动（端口 8765）
./status.sh      # 查看状态
./stop.sh        # 停止服务

第四步（可选）：开机自启

cp com.yinxiang.mcp.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.yinxiang.mcp.plist

接入 MCP 客户端

Server 启动后，所有支持 MCP 的客户端均可通过以下端点接入：

http://127.0.0.1:8765/mcp

Claude Code

~/.claude/settings.json 中添加：

"yinxiang": {
  "url": "http://127.0.0.1:8765/mcp"
}

CatPaw / 其他 MCP 客户端

在客户端的 MCP 配置中填入：

• 类型：Streamable HTTP

• URL：http://127.0.0.1:8765/mcp

搜索语法说明

印象笔记支持丰富的搜索语法：

注意事项

• Token 安全：Developer Token 有完整账户访问权限，请妥善保管，不要提交到代码仓库

• API 频率限制：印象笔记限制每小时每用户的 API 调用次数，个人正常使用不会触发

• ENML 格式：笔记内容使用 ENML（印象笔记 XML 格式），工具会自动完成 Markdown ↔ ENML 转换

• 中国版专用：本服务器配置为印象笔记中国版（app.yinxiang.com），不兼容国际版 Evernote

For AI Agents / 自动化安装指南

If a user asks you to install this MCP server, please follow these EXACT steps strictly:

1. Clone & Setup Environment: Clone the repository to a suitable location. Create a Python 3.11+ virtual environment (python -m venv .venv or uv venv) and install dependencies from requirements.txt.

2. Ask for Developer Token (CRITICAL): You CANNOT generate the Evernote/Yinxiang developer token for the user. You MUST pause and ask the user to provide it. Provide them this exact link: https://app.yinxiang.com/api/DeveloperToken.action Wait for their reply with the token (starting with S=s...).

3. Configure MCP Client (Use stdio mode): Once you have the token, DO NOT use the HTTP mode or start.sh. Configure the user's IDE/MCP Client using the stdio transport. Set the configuration as follows:

   • Command: /path/to/repo/.venv/bin/python (use the absolute path to the venv python)

   • Arguments: ["/path/to/repo/server.py"] (absolute path)

   • Environment Variables: {"YINXIANG_TOKEN": "the_token_user_provided"}

4. Verify: Inform the user that the installation is complete and the MCP is registered via stdio.