inkdropapp/mcp-server

Inkdrop MCP 服务器

Inkdrop 本地 HTTP 服务器 API 的模型上下文协议服务器。

安装

点击这里阅读相关文档。

组成部分

工具

1. read-note：通过数据库的ID获取笔记的完整内容。

• 所需输入：
• noteId：要检索的笔记ID。可在笔记文档中找到_id。它总是以note:开头。
• 可选输入：
• includeTemplate：当true且笔记带有sourceTemplateId]时，也获取该模板并将其正文（填写说明和示例）嵌入为额外文本块。默认：false。
• 注意：如果备注是从模板创建的，回复中包含指向其源模板的资源链接，正文包含填写说明和示例。

2. read-backlinks：获取笔记的反向链接——链接到该笔记的笔记。

• 所需输入：
• noteId：用于查找反向链接的笔记ID。它总是以note:开头。
• 注：每个结果以资源链接（[inkdrop://note/ ）返回，指向引用笔记。通过搜索所有笔记主体查找该笔记的链接URI来找到反向链接。

Inkdrop MCP Server

A Model Context Protocol server for the Inkdrop Local HTTP Server API.

Installation

Read the docs here.

Components

Tools

1. read-note: Retrieve the complete contents of the note by its ID from the database.
   • Required inputs:
     • noteId: The ID of the note to retrieve. It can be found as _id in the note docs. It always starts with note:.
   • Optional inputs:
     • includeTemplate: When true and the note has a sourceTemplateId, also fetch that template and embed its body (fill-out instructions and examples) as an extra text block. Default: false.
   • Note: If the note was created from a template, the response includes a resource link to its source template, whose body holds the fill-out instructions and examples.
2. read-backlinks: Retrieve backlinks for a note — the notes that link to it.
   • Required inputs:
     • noteId: The ID of the note to find backlinks for. It always starts with note:.
   • Note: Each result is returned as a resource link (inkdrop://note/) pointing to the referring note. Backlinks are found by searching all note bodies for the note’s link URI.
3. search-notes: List all notes that contain a given keyword.
   • Required inputs:
     • keyword: Keyword to search for.
   • Note: Results include truncated note bodies (200 characters). Use read-note to get full content.
   • Supports advanced search qualifiers like book:, tag:, status:, title:, etc.
4. list-notes: List all notes with specified conditions.
   • Required inputs:
     • bookId: The notebook ID. It always starts with ‘book:’.
   • Optional inputs:
     • tagIds: An array of tag IDs to filter. Each starts with ‘tag:’.
     • keyword: Keyword to filter notes.
     • sort: Sort field (updatedAt, createdAt, or title). Default: updatedAt.
     • descending: Reverse the order of output. Default: true.
   • Note: Results include truncated note bodies (200 characters). Use read-note to get full content.
5. list-templates: List note templates — your custom templates, followed by the official ones bundled with Inkdrop.
   • Optional inputs:
     • keyword: Filter templates by fuzzy-matching their titles.
   • Note: Results include truncated template bodies (200 characters). Use read-note to get full content.
6. create-note: Create a new note in the database.
   • Required inputs:
     • bookId: The notebook ID. Must start with ‘book:’ or be ‘trash’ or ‘template’. Specify ‘template’ to create a custom note template.
     • title: The note title.
     • body: The content of the note in Markdown.
   • Optional inputs:
     • status: The note status (none, active, onHold, completed, dropped).