スパイラルMCPサーバー

これは、Pythonを使用したSpiral APIのモデルコンテキストプロトコル（MCP）サーバー実装です。Spiralの言語モデルと対話するための標準化されたインターフェースを提供します。

インストール

mcp install src/server.py --name "spiral-writing-tool" --with pydantic --with requests --with beautifulsoup4 --with httpx

Related MCP server: MCP Server Example

設定

1. 仮想環境を作成してアクティブ化します。

python3 -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

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

uv pip install -r requirements.txt

3. ルート ディレクトリに.envファイルを作成し、Spiral API キーを追加します。

SPIRAL_API_KEY=your_api_key_here

APIキーはhttps://app.spiral.computer/apiから取得できます。

サーバーの実行

サーバーを起動します。

python src/server.py

サーバーはデフォルトでポート3000で動作します。PORT環境変数PORT設定することでこれを変更できます。

ツールのテスト

MCP ツールを直接テストするには:

python src/test_tools.py

これにより、利用可能なすべてのツールのテストが実行され、その機能が検証されます。

MCPツール

サーバーは 4 つの強力な MCP ツールを実装します。

リストモデル

利用可能なすべてのスパイラル モデルとその機能およびメタデータを一覧表示します。

応答例:

{
    "models": [
        {
            "id": "model-id",
            "name": "model-name",
            "description": "Model description",
            "input_format": "text",
            "output_format": "text",
            "capabilities": {
                "completion": true
            }
        }
    ]
}

生成する

指定されたスパイラル モデルを使用してテキストを生成します。

パラメータ:

• model : 使用するスパイラルモデルのIDまたはスラッグ

• prompt : 生成する入力テキスト

例：

{
    "model": "model_id_or_slug",
    "prompt": "Your input text here"
}

ファイルから生成

ファイルからの入力に基づき、スパイラルモデルを用いてテキストを生成します。これは、大規模なドキュメントの処理や、一貫した書式設定の維持に役立ちます。

パラメータ:

• model : 使用するスパイラルモデルのIDまたはスラッグ

• file_path : 入力として使用するファイルへのパス

例：

{
    "model": "model_id_or_slug",
    "file_path": "path/to/your/input.txt"
}

生成元URL

URLからの入力に基づき、スパイラルモデルを用いてテキストを生成します。このツールは、Webページから記事のコンテンツを自動的に抽出できます。

パラメータ:

• model : 使用するスパイラルモデルのIDまたはスラッグ

• url : コンテンツを取得するURL

• extract_article : 記事の内容を抽出するか、完全な HTML を使用するか (デフォルト: true)

例：

{
    "model": "model_id_or_slug",
    "url": "https://example.com/article",
    "extract_article": true
}

エラー処理

サーバーは、次のようなさまざまなエラーケースを処理します。

• 無効なAPIキー

• モデルが見つかりません

• 入力が長すぎます

• レート制限を超えました

• URL 取得の失敗

• ファイル読み取りエラー

• サーバーエラー

• リクエストタイムアウト

各エラーは、問題の診断に役立つ明確なエラー メッセージを返します。

環境変数

• SPIRAL_API_KEY : Spiral APIキー（必須）

• PORT : サーバーポート（オプション、デフォルトは3000）

• TIMEOUT : リクエストのタイムアウト（秒）（オプション、デフォルトは30）

特徴

• 堅牢なエラー処理: すべての操作に対する包括的なエラー処理とログ記録

• 記事抽出: Webページから記事のコンテンツをスマートに抽出します

• 柔軟な入力ソース: テキスト、ファイル、URLを入力としてサポート

• 非同期操作: パフォーマンス向上のため、すべての操作は非同期です。

• 型安全性: すべてのパラメータに対して完全なPydantic型検証を実施

• ログ記録: トラブルシューティングのための詳細なデバッグログ