Non Dirty MCP Client And Server

MCPプロトコルを実装したクライアントとサーバーのプロジェクトで、ノートの保存、要約生成、ノートの追加機能を提供します。

ノートツール知識管理と記憶 #ノート管理 #プロトコルサービス #要約生成 .Python

rating : 2 points

downloads : 18

update time : 2025-04-29

MCPサーバーとは？

MCPサーバーは、モデルコンテキストプロトコルをサポートするツールで、ユーザーがノートを保存、管理、要約を生成できます。カスタムのnote:// URIスキームを通じて個々のノートにアクセスし、要約生成機能を提供します。

MCPサーバーの使い方は？

ユーザーは、ノートを追加し、スタイルを設定し、要約を生成することでサーバーを使用できます。サーバーは自動的にノートの状態を更新し、クライアントに変更通知を送信します。

適用シナリオ

ノートを効率的に管理し、要約を生成する必要がある個人またはチーム、例えば学生、研究者、企業ユーザーに適しています。

主な機能

ノート保存システムカスタムのnote:// URIスキームを通じてノートにアクセスし、管理することをサポートします。

要約生成ユーザーが選択したスタイル（簡潔/詳細）に基づいて、すべてのノートの要約を生成します。

新しいノートを追加コマンドラインを通じて新しいノートを追加し、即座にサーバーに同期することをサポートします。

利点と制限

利点

使いやすいコマンドラインインターフェイス

複数のスタイルの要約生成をサポート

リアルタイム更新と通知機能

制限

コマンドライン操作に依存している

ネットワーク環境に一定の要求がある

使い方

MCPサーバーをインストールする

ドキュメントの指示に従って、MCPサーバーをダウンロードしてインストールします。

サーバーを起動する

ターミナルで起動コマンドを実行して、サーバーを初期化します。

ノートを追加する

add - noteコマンドを使用して新しいノートを追加します。

要約を生成する

summarize - notesコマンドを呼び出してノートの要約を生成します。

使用例

ノートを追加するサーバーに新しいノートを追加します。

要約を生成するすべてのノートの詳細な要約を生成します。

よくある質問

MCPサーバーをどのようにインストールしますか？

ノートの要約をどのように生成しますか？

サーバーはリアルタイム更新をサポートしていますか？

🚀 MCP クライアントとサーバー

モデルコンテキストプロトコルのクライアントとサーバーは、クライアントとサーバーを連鎖的に接続するために使用されます。

✨ 主な機能

リソース

サーバーは、以下の機能を備えたシンプルなノート保存システムを実装しています。

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

プロンプト

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

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

ツール

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

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

📦 インストール

クイックスタート

MacOS でのインストール：

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows でのインストール：

%APPDATA%/Claude/claude_desktop_config.json

開発/未公開のサーバー設定

``` "mcpServers": { "mcp-client-and-server": { "command": "uv", "args": [ "--directory", "/Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server", "run", "mcp-client-and-server" ] } } ```

公開済みのサーバー設定

``` "mcpServers": { "mcp-client-and-server": { "command": "uvx", "args": [ "mcp-client-and-server" ] } } ```

💻 使用例

ビルドと公開

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

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

uv sync

パッケージのリリースバージョンをビルドします。

uv build

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

PyPI に公開します。

uv publish

注意: PyPI の認証情報は、環境変数またはコマンドライン引数で設定する必要があります。

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

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP インスペクターの使用を強くおすすめします。

以下のコマンドで MCP インスペクターを起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server run mcp-client-and-server

起動後、インスペクターはブラウザーに URL を表示し、そこでデバッグを開始できます。