项目简介

Inkdrop MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，专为 Inkdrop 笔记应用设计。它允许大型语言模型 (LLM) 客户端安全地访问和操作您的 Inkdrop 笔记数据，从而实现更智能的笔记管理和内容交互。通过此服务器，LLM 可以检索笔记内容、搜索特定笔记、创建新笔记、更新现有笔记以及获取笔记本和标签列表，极大地扩展了 LLM 在个人知识管理和内容创作方面的应用场景。

请注意： 该项目目前处于实验阶段，使用需谨慎。

主要功能点

资源访问: 通过 'note' 资源模板，允许 LLM 客户端根据笔记 ID 获取笔记的 JSON 数据。
强大的工具集: 提供以下工具，方便 LLM 客户端与 Inkdrop 笔记进行交互：
- 'read-note': 根据笔记 ID 读取完整的笔记内容。
- 'search-notes': 根据关键词搜索笔记，支持多种高级搜索限定符（如笔记本、标签、状态、标题等）。
- 'list-notes': 列出指定笔记本中的所有笔记，支持按标签、关键词、排序等条件过滤。
- 'create-note': 在指定笔记本中创建新笔记，可设置标题、内容和状态。
- 'update-note': 更新已存在的笔记，可以修改笔记本、标题、内容和状态。
- 'list-notebooks': 获取所有笔记本的列表。
- 'list-tags': 获取所有标签的列表。
Prompt 模板: 内置 'inkdrop-prompt' 模板，为 LLM 提供 Inkdrop MCP 服务器的使用指南和最佳实践，并包含 Note, Book, Tag 的数据模型结构，帮助 LLM 更好地理解和使用这些工具。

安装步骤

安装 Inkdrop 本地 HTTP 服务器: 首先，您需要安装并配置 Inkdrop 的本地 HTTP 服务器 API。请参考 Inkdrop 官方文档完成配置。确保您的本地 HTTP 服务器可以正常访问。
配置 Claude Desktop (或其他 MCP 客户端): 如果您使用 Claude Desktop 作为 MCP 客户端，您需要修改 Claude 的配置文件 'claude_desktop_config.json' 以添加 Inkdrop MCP 服务器的配置。
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
将以下 JSON 配置添加到 'claude_desktop_config.json' 文件的 '"mcpServers"' 字段中：

{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": [
        "-y",
        "@inkdropapp/mcp-server"
      ],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",  // 您的 Inkdrop 本地 HTTP 服务器地址
        "INKDROP_LOCAL_USERNAME": "your-local-server-username", // 您的 Inkdrop 本地 HTTP 服务器用户名
        "INKDROP_LOCAL_PASSWORD": "your-local-server-password"  // 您的 Inkdrop 本地 HTTP 服务器密码
      }
    }
  }
}

配置参数说明:

'"inkdrop"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 运行 npm 包。
'"args": ["-y", "@inkdropapp/mcp-server"]': 'npx' 命令的参数，'-y' 表示自动安装依赖，'@inkdropapp/mcp-server' 是要运行的 npm 包名称。
'"env"': 环境变量配置。
- '"INKDROP_LOCAL_SERVER_URL"': 必填，您的 Inkdrop 本地 HTTP 服务器的 URL 地址，通常为 'http://localhost:19840'，请根据您的实际配置修改。
- '"INKDROP_LOCAL_USERNAME"': 必填，访问 Inkdrop 本地 HTTP 服务器的用户名。
- '"INKDROP_LOCAL_PASSWORD"': 必填，访问 Inkdrop 本地 HTTP 服务器的密码。

注意: 请务必将 '"INKDROP_LOCAL_SERVER_URL"'、'"INKDROP_LOCAL_USERNAME"' 和 '"INKDROP_LOCAL_PASSWORD"' 替换为您的 Inkdrop 本地 HTTP 服务器的实际配置信息。

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude Desktop）应该能够检测到名为 "inkdrop" 的 MCP 服务器。您可以在客户端中通过以下方式使用 Inkdrop MCP 服务器的功能：

在 LLM 对话中提及相关需求: 例如，您可以对 Claude 说 "搜索包含 'MCP协议' 关键词的笔记" 或 "列出 '工作' 笔记本中的所有笔记"。
LLM 客户端会自动调用相应的工具: Claude Desktop 等 MCP 客户端会解析您的指令，并根据配置的 MCP 服务器能力，自动调用 'search-notes' 或 'list-notes' 等工具来满足您的需求。
获取笔记数据: 服务器会将查询到的笔记信息以 JSON 格式返回给 LLM 客户端，LLM 可以利用这些信息进行后续的自然语言处理和内容生成任务。

调试: 如果遇到问题，可以使用 MCP Inspector 工具进行调试，或者查看服务器日志文件 '~/Library/Logs/Claude/mcp-server-inkdrop.log' (MacOS) 获取更多信息。

关键词

项目简介

主要功能点

安装步骤

基本使用方法

信息