mcp-server-on-raspi MCP server

mcp-server-on-raspi MCP server

site icon
2024.12.27 0
Python笔记管理笔记摘要其它
daikw_mcp-server-on-raspi 是一个基于 MCP 协议的服务器项目,主要用于实现一个简单的笔记存储系统。它提供了自定义的 note:// URI 方案来访问单个笔记,每个笔记资源包含名称、描述和文本/纯文本的 MIME 类型。服务器还提供了一个提示功能来汇总所有存储的笔记,并支持通过工具添加新笔记。
View on GitHub

Overview

基本能力

产品定位

daikw_mcp-server-on-raspi 是一个基于 MCP 协议的服务器项目,主要用于实现一个简单的笔记存储系统。

核心功能

  1. 笔记存储系统
  2. 自定义 note:// URI 方案用于访问单个笔记
  3. 每个笔记资源包含名称、描述和文本/纯文本的 MIME 类型

  4. 提示功能

  5. summarize-notes:创建所有存储笔记的摘要

    • 可选的 "style" 参数控制详细程度(brief/detailed)
    • 生成结合所有当前笔记和风格偏好的提示
  6. 工具

  7. add-note:向服务器添加新笔记
    • 需要 "name" 和 "content" 作为必需的字符串参数
    • 更新服务器状态并通知客户端资源更改

适用场景

  1. 个人笔记管理
  2. 笔记摘要生成
  3. 笔记共享与协作

工具列表

  1. add-note
  2. 能力:向服务器添加新笔记
  3. 参数:"name"(名称)和 "content"(内容)

常见问题解答

  1. 如何调试 MCP 服务器?
  2. 由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性。建议使用 MCP Inspector 进行调试。

使用教程

使用依赖

  1. 安装 Claude Desktop:
  2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

安装教程

  1. 开发/未发布服务器配置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" ] } }

  2. 已发布服务器配置json "mcpServers": { "mcp-server-on-raspi": { "command": "uvx", "args": [ "mcp-server-on-raspi" ] } }

调试方式

  1. 使用 MCP Inspector 进行调试: bash npx @modelcontextprotocol/inspector uv --directory /Users/daikiwatanabe/ghq/github.com/daikw/mcp-server-on-raspi run mcp-server-on-raspi

  2. 构建和发布:

  3. 同步依赖并更新锁文件: bash uv sync
  4. 构建包分发: bash uv build
  5. 发布到 PyPI: bash uv publish
    • 需要设置 PyPI 凭据(通过环境变量或命令标志)

许可证

None