Inkdrop MCP Server

Inkdrop MCP Server

site icon
2025.05.07 0
JavaScript笔记管理数据访问开发效率
Inkdrop MCP Server 是一个基于 Model Context Protocol 的服务器,专为 Inkdrop 本地 HTTP 服务器 API 设计。它提供了一系列工具来管理和操作 Inkdrop 中的笔记、笔记本和标签,支持笔记的创建、读取、更新、搜索和列表等功能。
View on GitHub

Overview

基本能力

产品定位

Inkdrop MCP Server 是一个用于管理和操作 Inkdrop 笔记数据的中间件服务,通过本地 HTTP 服务器 API 提供数据访问和操作能力。

核心功能

  1. 笔记管理:支持创建、读取、更新和搜索笔记。
  2. 笔记本和标签管理:支持列出所有笔记本和标签。
  3. 高级搜索:支持按关键词、笔记本、标签等条件搜索笔记。

适用场景

  1. 开发者需要通过程序化方式访问和操作 Inkdrop 笔记数据。
  2. 需要集成 Inkdrop 数据到其他应用或工作流中。

工具列表

  1. read-note:通过笔记 ID 获取完整笔记内容。
  2. search-notes:按关键词搜索笔记(返回截断内容)。
  3. list-notes:按条件列出笔记(返回截断内容)。
  4. create-note:创建新笔记。
  5. update-note:更新现有笔记。
  6. list-notebooks:列出所有笔记本。
  7. list-tags:列出所有标签。

常见问题解答

  1. 调试困难:建议使用 MCP Inspector 进行调试。
  2. 日志查看:可以通过 tail 命令查看服务器日志。

使用教程

使用依赖

  1. 设置本地 HTTP 服务器:参考指南

安装教程

  1. 添加服务器配置到 Claude Desktop:
  2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": ["-y", "@inkdropapp/mcp-server"],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "your-local-server-username",
        "INKDROP_LOCAL_PASSWORD": "your-local-server-password"
      }
    }
  }
}

调试方式

  1. 使用 MCP Inspector 调试:
npx @modelcontextprotocol/inspector "./dist/index.js"
  1. 查看服务器日志:
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-inkdrop.log

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。