MCP Server On Raspi

🚀 ラズパイ上で動作するMCPサーバー

このプロジェクトは、ラズパイ上で動作するMCPサーバーを提供します。

🚀 クイックスタート

インストール

Claude Desktop

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

✨ 主な機能

リソース

このサーバーは、簡単なノート保存システムを実装しています。以下の特徴があります。

• 単一のノートにアクセスするためのカスタムnote:// URIスキーム
• 各ノートリソースには、名前、説明、text/plain MIMEタイプがあります。

プロンプト

このサーバーは、以下のプロンプトを提供します。

• summarize-notes：保存されているすべてのノートの要約を生成します。
  • 詳細度を制御するためのオプションの「スタイル」パラメーター（簡潔/詳細）
  • スタイルの好みに基づいて、現在のすべてのノートを含むプロンプトを生成します。

ツール

このサーバーは、以下のツールを実装しています。

• add-note：サーバーに新しいノートを追加します。
  • 「名前」と「内容」を必須の文字列パラメーターとして受け取ります。
  • サーバーの状態を更新し、クライアントにリソースの変更を通知します。

📚 ドキュメント

構築と公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布を構築します。

uv build

これにより、dist/ ディレクトリにソースコードとホイール配布が作成されます。

3. PyPIに公開します。

uv publish

注意：環境変数またはコマンドフラグを使用してPyPIの資格情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdioを介して実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

npm を使用して、以下のコマンドでMCP Inspectorを起動できます。

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

起動後、InspectorはURLを表示します。このURLをブラウザで開くと、デバッグを開始できます。