内容
# 印象笔记MCP服务端
印象笔记(Yinxiang / Evernote China)的 MCP server。通过 stdio 提供笔记读写工具,支持 Markdown 与 ENML 互转。
## 安装
```bash
npx -y @__shiyi/印象笔记-mcp
```
## 认证
直接使用Token模式,不走 OAuth。需要两个环境变量:
- `印象笔记开发者令牌` — 开发者令牌,在 <https://dev.yinxiang.com> 申请
- `印象笔记存储地址` — 存储地址,如 `https://app.yinxiang.com/shard/s68/notestore`
## 接入 Claude
```json
{
"mcpServers": {
"印象笔记": {
"command": "npx",
"args": ["-y", "@__shiyi/印象笔记-mcp"],
"env": {
"印象笔记开发者令牌": "<令牌>",
"印象笔记存储地址": "https://app.yinxiang.com/shard/sXX/notestore"
}
}
}
}
```
## 工具
- `列出笔记本` — 列出笔记本
- `搜索笔记`(`关键词`, `笔记本Guid`, `最大结果数`)— 搜索笔记
- `新建笔记`(`标题`, `内容`, `笔记本Guid`)— 新建笔记,Markdown 转 ENML
- `读取笔记`(`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