convez.ai
MCP ServerProdutividadeIntermediário
iswalle

GetNote MCP - Gerenciador de Notas com IA

iswalle/getnote-mcp

Integre gerenciamento de notas pessoais ao Claude e outros modelos IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra o GetNote (得到大脑), ferramenta de gerenciamento pessoal de notas, com modelos de IA. Permite criar, atualizar, buscar e organizar notas através de comandos naturais, além de suportar upload de imagens e busca semântica em conhecimentos.

Instalação

$npx convez-ai iswalle/getnote-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
93
Forks
10
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
v1.12.3
Issues abertas
0
Contribuidores
7

Casos de uso

  • Capturar notas rápidas durante conversas com IA
  • Buscar notas anteriores por conteúdo semântico
  • Organizar notas em conhecimentos e coleções temáticas
  • Upload automático de imagens e links como notas

Veredito

MCP bem estruturado com cobertura completa da API GetNote. Requer API Key/Client ID da plataforma chinesa e OAuth, limitado ao ecossistema Get笔记, mas oferece ferramentas robustas para gerenciamento de notas documentadas e testadas.

README

A tradução para o português deste README ainda está na fila.

MseeP.ai Security Assessment Badge

getnote-mcp

MCP (Model Context Protocol) server for 得到大脑(Get笔记) Open API.

得到大脑(Get笔记)是一款个人笔记管理工具。通过此 MCP Server,AI 模型可以帮助用户管理笔记。

🔑 获取 API Key:https://www.biji.com/openapi

使用场景

  • 用户说「帮我记一下」「保存到笔记」「记录下来」→ save_note
  • 用户说「改一下这个笔记」「更新笔记内容」→ update_note
  • 用户说「查一下我的笔记」「找找之前的笔记」→ list_notes
  • 用户说「搜一下」「找找我哪些笔记提到了 XX」→ recall
  • 用户说「在 XX 知识库搜一下」→ recall_knowledge
  • 用户分享了一个链接,说「保存这个」→ save_note(链接笔记)
  • 用户说「给这个笔记加个标签」→ add_note_tags

Features

Exposes the following tools to AI models:

ToolDescription
list_notes获取笔记列表(游标分页)
get_note获取笔记详情(支持 image_quality=original 获取原图)
save_note新建笔记(纯文本/链接/图片,见下方类型说明)
update_note更新笔记(标题/内容/标签,仅支持 plain_text 类型)
get_note_task_progress查询创建笔记任务进度(链接/图片笔记)
delete_note删除笔记(移入回收站)
add_note_tags添加笔记标签
delete_note_tag删除笔记标签
recall全局语义搜索(在所有笔记中搜索)
recall_knowledge知识库语义搜索(在指定知识库中搜索)
list_topics获取知识库列表
create_topic创建知识库
list_topic_notes获取知识库笔记列表
batch_add_notes_to_topic批量添加笔记到知识库
remove_note_from_topic从知识库移除笔记
get_upload_config获取图片上传配置
get_upload_token获取图片上传凭证(预签名 URL)
upload_image完整图片上传(自动获取凭证 + 上传到 OSS)
list_topic_bloggers获取知识库订阅的博主列表
list_topic_blogger_contents获取博主内容列表(摘要)
get_blogger_content_detail获取博主内容详情(含原文)
list_topic_lives获取知识库已完成直播列表
get_live_detail获取直播详情(含 AI 摘要和原文转写)
get_quota查询 API 调用配额
share_note生成笔记分享链接
follow_topic_live在知识库里订阅得到直播
list_subscribe_topics获取我订阅的知识库列表

Installation

# 直接运行(推荐,无需克隆)
npx @getnote/mcp

# 或全局安装
npm install -g @getnote/mcp

Usage

授权登录(推荐)

首次使用时,在 AI 对话里说「请帮我授权 得到大脑(Get笔记)」,AI 会自动引导 OAuth 登录,无需手动配置。

手动配置 API Key(备选)

获取 API Key 和 Client ID:https://www.biji.com/openapi

Environment variable

# 临时使用
GETNOTE_API_KEY=your_api_key GETNOTE_CLIENT_ID=your_client_id node dist/index.js

# 持久化(添加到 ~/.zshrc 或 ~/.bashrc)
export GETNOTE_API_KEY=gk_live_xxx
export GETNOTE_CLIENT_ID=cli_xxx

CLI flag

node dist/index.js --api-key your_api_key --client-id your_client_id

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "getnote": {
      "command": "node",
      "args": ["/path/to/getnote-mcp/dist/index.js"],
      "env": {
        "GETNOTE_API_KEY": "your_api_key_here",
        "GETNOTE_CLIENT_ID": "your_client_id_here"
      }
    }
  }
}

Limits

ItemLimit
每日知识库创建上限每个账号每天最多创建 50 个知识库
重置时间按 北京时间自然日 00:00 重置

⚠️ 超出限制时,create_topic 接口将返回 429 错误(reason: quota_daily_exceeded)。

Notes on Note Types

save_note supports three note types:

TypeDescription
plain_text纯文本笔记(默认)
link链接笔记(需传 link_url)
img_text图片笔记(需传 image_urls,通过上传图片到 OSS 获取)

语音笔记等其他类型只能在 得到大脑(Get笔记) App 或 Web 端创建,MCP 可以读取但无法创建。

图片上传流程

通过 MCP 上传图片创建笔记需要三步:

1. 获取上传凭证

Tool: get_upload_token
Input: { "mime_type": "png" }

返回 OSS 上传凭证:

{
  "accessid": "LTAI5t...",
  "host": "https://ali-bj2-oss-get-notes-prod.oss-accelerate.aliyuncs.com",
  "policy": "eyJleHBpcmF...",
  "signature": "nhyBord...",
  "callback": "eyJjYWxs...",
  "object_key": "get_notes_prod/...",
  "access_url": "https://ali-bj2-oss-get-notes-prod.oss-accelerate.aliyuncs.com/...",
  "oss_content_type": "image/png"
}

2. 上传到 OSS

使用凭证通过 multipart/form-data POST 上传:

curl -X POST "${host}" \
  -F "OSSAccessKeyId=${accessid}" \
  -F "policy=${policy}" \
  -F "Signature=${signature}" \
  -F "key=${object_key}" \
  -F "callback=${callback}" \
  -F "success_action_status=200" \
  -F "file=@/path/to/image.png;type=${oss_content_type}"

3. 创建图片笔记

使用凭证中的 access_url 创建笔记:

Tool: save_note
Input: {
  "title": "图片笔记",
  "note_type": "img_text",
  "image_urls": ["${access_url}"]
}

简化流程:也可以直接使用 upload_image 工具,它会自动完成步骤 1 和 2,返回 image_url。

API

  • Base URL: https://openapi.biji.com/open/api/v1
  • Auth: Bearer Token (API Key)

Get your API Key and Client ID at 得到大脑(Get笔记)开放平台.

🚀 进阶用法:用笔记内链实践柳比歇夫时间日志法

柳比歇夫时间日志法的核心是每天记录自己把时间花在了哪里,事后统计、复盘、改进。

结合 得到大脑(Get笔记)内链,AI 可以帮你自动串联:

每天早上

👤 帮我记一条今日工作日志,内链到「产品设计方案」和「客户反馈」这两条笔记

🤖 已记录「2026-04-24 工作日志」,正文已插入两条内链。

每周复盘

👤 找找我这周的工作日志,整理一下时间分配

🤖 找到 5 条日志,你这周:产品设计 12h、客户沟通 6h、开会 4h……

内链格式:在笔记正文里用 https://biji.com/note/{note_id} 引用其他笔记。示例:

参考上次的讨论:https://biji.com/note/1234567890000000001

告诉 AI 要内链到哪条笔记,AI 会自动获取对应 note_id 插入。


🆕 更新日志

日期版本新能力适合怎么用
2026-04-23v1.3.11. 笔记内链2. 保存分享链接自动变笔记1. 用内链串联每天的工作日志和项目笔记,实践时间日志法2. 收到别人发来的分享链接直接存入笔记
2026-04-16v1.3.01. 生成笔记分享链接2. 知识库订阅得到直播1. 把笔记一键分享给朋友2. 在知识库里订阅得到直播课,直播结束后 AI 摘要自动入库
2026-03-23v1.2.x获取我订阅的知识库,支持语义搜索开通了某个知识库,可以直接问 AI:「在我订阅的 XXX 知识库里搜一下时间管理」
2026-03-12v1.2.0查看订阅博主内容、直播摘要和转写原文把别人的知识变成自己可检索的笔记库

License

MIT

Ver o original no GitHub

Bom para

Relacionados