MCP Server on Raspi

Um sistema simples de armazenamento de notas com um esquema de URI personalizado note://, permitindo que os usuários adicionem e resumam notas.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP mcp-server-on-raspi

Um projeto de servidor MCP

Componentes

Recursos

O servidor implementa um sistema simples de armazenamento de notas com:

  • Esquema de URI customizado note:// para acessar notas individuais
  • Cada recurso de nota possui um nome, descrição e tipo MIME text/plain

Prompts

O servidor fornece um único prompt:

  • summarize-notes: Cria resumos de todas as notas armazenadas
    • Argumento opcional "style" para controlar o nível de detalhe (breve/detalhado)
    • Gera prompt combinando todas as notas atuais com a preferência de estilo

Ferramentas

O servidor implementa uma ferramenta:

  • add-note: Adiciona uma nova nota ao servidor
    • Recebe "name" e "content" como argumentos de string obrigatórios
    • Atualiza o estado do servidor e notifica clientes sobre mudanças nos recursos

Configuração

[TODO: Adicionar detalhes de configuração específicos da sua implementação]

Início Rápido

Instalação

Claude Desktop

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

Development/Unpublished Servers Configuration ``` "mcpServers": { "mcp-server-on-raspi": { "command": "uv", "args": [ "--directory", "/Users/daikiwatanabe/ghq/github.com/daikw/mcp-server-on-raspi", "run", "mcp-server-on-raspi" ] } } ```
Published Servers Configuration ``` "mcpServers": { "mcp-server-on-raspi": { "command": "uvx", "args": [ "mcp-server-on-raspi" ] } } ```

Desenvolvimento

Build e Publicação

Para preparar o pacote para distribuição:

  1. Sincronize as dependências e atualize o lockfile:
uv sync
  1. Crie as distribuições do pacote:
uv build

Isso criará distribuições source e wheel no diretório dist/.

  1. Publique no PyPI:
uv publish

Nota: Você precisará definir as credenciais do PyPI via variáveis de ambiente ou flags de comando:

  • Token: --token ou UV_PUBLISH_TOKEN
  • Ou usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP rodam via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

npx @modelcontextprotocol/inspector uv --directory /Users/daikiwatanabe/ghq/github.com/daikw/mcp-server-on-raspi run mcp-server-on-raspi

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.