# yinxiang-mcp

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

## 安装

```bash
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

```json
{
  "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

## 本地开发

```bash
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