mcp-server-on-raspi MCP server

概述

MCP Server 是一个轻量级笔记管理系统，提供自定义 URI 访问、笔记摘要和笔记同步功能。

主要功能

• 笔记存储：使用自定义 note:// URI 方案访问笔记
• 提示功能：summarize-notes 创建已存储笔记的摘要
• 工具：add-note 添加新笔记到服务器

安装配置

Claude 桌面版配置

位置：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

开发环境配置：

"mcpServers": {
  "mcp-server-on-raspi": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/daikiwatanabe/ghq/github.com/daikw/mcp-server-on-raspi",
      "run",
      "mcp-server-on-raspi"
    ]
  }
}

生产环境配置：

"mcpServers": {
  "mcp-server-on-raspi": {
    "command": "uvx",
    "args": [
      "mcp-server-on-raspi"
    ]
  }
}

开发指南

构建与发布

1. 同步依赖：

   uv sync
   

2. 构建包：

   uv build
   

3. 发布到 PyPI：

   uv publish
   

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /path/to/project run mcp-server-on-raspi

访问 Inspector 提供的 URL 开始调试。

使用方法

• 添加笔记：使用 add-note 工具，提供 name 和 content 参数
• 获取摘要：使用 summarize-notes 提示，可选 style 参数（简洁/详细）
• 访问笔记：使用 note:// URI 方案