MCP Server Singlestore

🚀 SingleStore MCP サーバー

モデルコンテキストプロトコル (MCP) は、大規模言語モデル (LLMs) と外部システム間でコンテキストを管理するための標準化されたプロトコルです。このリポジトリは、インストーラーと SingleStore の MCP サーバーを提供し、シームレスな統合を実現します。

MCP を通じて、Claude Desktop、Cursor または互換性のある任意の MCP クライアントを使用して、自然言語で複雑な操作を簡単に実行できます。

🚀 クイックスタート

このセクションでは、SingleStore MCP サーバーのクイックスタートについて説明します。

✨ 主な機能

• MCP を通じて、大規模言語モデルと外部システム間のコンテキスト管理を実現します。
• Claude Desktop、Cursor などの MCP クライアントとの互換性があり、自然言語での操作を可能にします。

📦 インストール

必要条件

• Python >= v3.11.0
• uvx が Python 環境にインストールされていること
• Claude Desktop、Cursor または他のサポートされる LLM クライアントがインストールされていること

クライアント設定

1. 初期化コマンド

MCP サーバーをすばやく設定するには、以下の初期化コマンドを使用します。

# パッケージのインストール
pip install mcp-server-singlestore

# MCP サーバーの起動
mcp-server-singlestore start

2. Smithery を使用したインストール

以下の手順で Smithery を使用してインストールします。

1. Smithery を開きます。
2. singlestore/mcp-server-singlestore を検索して選択します。
3. "Get Started" をクリックし、指示に従ってインストールを完了します。

3. 手動設定

~/.config/mcp-server-singlestore/config.json に以下の内容を追加します。

{
  "port": 5005,
  "singlestore-endpoint": "your-endpoint.example.com",
  "api-key": "your-api-key"
}

サービスを起動します。

mcp-server-singlestore start --config ~/.config/mcp-server-singlestore/config.json

インストール方法

1. pip を使用したインストール

pip を使用して直接インストールします。

pip install mcp-server-singlestore

2. Docker を使用したデプロイ

イメージを取得して実行します。

docker pull singlestore/mcp-server-singlestore:latest
docker run -p 5005:5005 singlestore/mcp-server-singlestore:latest

3. 手動ビルド

ソースコードからコンパイルしてインストールします。

1. リポジトリをクローンします。

git clone https://github.com/singlestore-labs/mcp-server-singlestore.git
cd mcp-server-singlestore

2. 依存関係をインストールします。

pip install -r requirements.txt

3. サービスを起動します。

python -m mcp_server_singlestore server --port 5005

💻 使用例

基本的な使用法

from mcp_server_singlestore import MCPClient

client = MCPClient('localhost', 5005)
print(client.get_metrics())

高度な使用法

from mcp_server_singlestore import MCPClient, StressTestParams

params = StressTestParams(
    num_threads=10,
    duration=60
)

client = MCPClient('localhost', 5005)
client.run_stress_test(params)

📚 ドキュメント

コンポーネント

MCP サーバー

• リッスンポート: 指定された TCP ポートをリッスンします。デフォルトは 5005 です。
• シングルトンモード: 1 つのインスタンスのみが実行され、ポートの競合やリソースの競争を防ぎます。
• ログ記録: すべてのリクエストとレスポンスを記録し、デバッグや監視に役立ちます。

ツール

以下の機能を提供します。

• メトリクス収集: システムのパフォーマンスメトリクス（CPU、メモリ使用率など）を収集します。
• ヘルスチェック: 定期的にヘルスチェックを実行し、サービスが正常に動作していることを確認します。
• 拡張性テスト: ストレステストを実行し、システムの最大負荷能力を評価します。
• 設定検証: 設定ファイルの正しさと完全性を検証します。

ツールリスト

以下のツールについて詳細な情報を提供します。

基本機能

1. メトリクス収集
   • GET /metrics: 現在のシステムパフォーマンスメトリクスを返します。
2. ヘルスチェック
   • GET /healthz: サービスが正常に動作しているかを確認します。
3. 拡張性テスト
   • POST /stress-test: ストレステストを実行し、負荷パラメータを指定します。
4. 設定検証
   • POST /config/validate: 設定ファイルの有効性を検証します。

高度な機能

1. ログ記録
   • GET /logs: 最近のログエントリを返します。
   • POST /logs/clear: すべてのログをクリアします。
2. 監視統合
   • Prometheus 形式のメトリクス出力をサポートし、Grafana などのツールとの統合を容易にします。
3. カスタムプラグイン
   • ユーザーがカスタムプラグインを追加して構成でき、機能を拡張できます。

🔧 技術詳細

コンポーネント

MCP サーバー

• リッスンポート: 指定された TCP ポートをリッスンします。デフォルトは 5005 です。これにより、外部からのリクエストを受け付けることができます。
• シングルトンモード: 1 つのインスタンスのみが実行されるため、ポートの競合やリソースの競争を防ぐことができます。
• ログ記録: すべてのリクエストとレスポンスを記録します。これにより、デバッグや監視が容易になります。

ツール

• メトリクス収集: システムのパフォーマンスメトリクス（CPU、メモリ使用率など）を収集します。これにより、システムの状態を把握することができます。
• ヘルスチェック: 定期的にヘルスチェックを実行し、サービスが正常に動作していることを確認します。
• 拡張性テスト: ストレステストを実行し、システムの最大負荷能力を評価します。
• 設定検証: 設定ファイルの正しさと完全性を検証します。

ツールリスト

基本機能

• メトリクス収集: GET /metrics エンドポイントを使用して、現在のシステムパフォーマンスメトリクスを取得できます。
• ヘルスチェック: GET /healthz エンドポイントを使用して、サービスが正常に動作しているかを確認できます。
• 拡張性テスト: POST /stress-test エンドポイントを使用して、ストレステストを実行できます。
• 設定検証: POST /config/validate エンドポイントを使用して、設定ファイルの有効性を検証できます。

高度な機能

• ログ記録: GET /logs エンドポイントを使用して、最近のログエントリを取得できます。POST /logs/clear エンドポイントを使用して、すべてのログをクリアできます。
• 監視統合: Prometheus 形式のメトリクス出力をサポートしているため、Grafana などのツールとの統合が容易です。
• カスタムプラグイン: ユーザーがカスタムプラグインを追加して構成でき、機能を拡張できます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE を参照してください。

ドキュメント貢献者

• 張三: 初期翻訳とドキュメント構造の調整
• 李四: 技術用語の校正と補足説明
• 王五: サンプルコードの最適化とテスト検証