MCP Server Opensearch

🚀 MCP サーバー OpenSearch バージョン

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/ ディレクトリにソースコードと wheel 配布バージョンが作成されます。

3. PyPI に公開します。

uv publish

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

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

🐞 デバッグ

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

npm がインストールされていると仮定して、以下のコマンドで MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/gowtham/Gowtham/Projects/mcp-server-opensearch run mcp-server-opensearch

起動後、Inspector は URL を表示し、ブラウザでその URL にアクセスするとデバッグを開始できます。