yinxiang-mcp

印象笔记（Yinxiang / Evernote China）的 MCP server。通过 stdio 提供笔记读写工具，支持 Markdown 与 ENML 互转。

安装

npx -y @__shiyi/yinxiang-mcp

认证

Direct Token 模式，不走 OAuth。需要两个环境变量：

• YINXIANG_DEV_TOKEN — Developer Token，在 https://dev.yinxiang.com 申请

• YINXIANG_NOTESTORE_URL — NoteStore URL，如 https://app.yinxiang.com/shard/s68/notestore

接入 Claude

{
  "mcpServers": {
    "yinxiang": {
      "command": "npx",
      "args": ["-y", "@__shiyi/yinxiang-mcp"],
      "env": {
        "YINXIANG_DEV_TOKEN": "<token>",
        "YINXIANG_NOTESTORE_URL": "https://app.yinxiang.com/shard/sXX/notestore"
      }
    }
  }
}

工具

• list-notebooks — 列出笔记本

• find-notes（words, notebookGuid, maxResults）— 搜索笔记

• create-note（title, content, notebookGuid）— 新建笔记，Markdown 转 ENML

• get-note（guid）— 读取笔记，ENML 转 Markdown

本地开发

npm install
cp .env.example .env
npm run verify     # 连通性验证
npm run test-rw    # 读写 round-trip 测试
npm start

限制

• evernote@2.0.5，EDAM API 偏旧

• Markdown 转换覆盖基础语法；任务列表、附件暂不支持

• MIT