スパイラルMCPサーバー

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

インストール

Related MCP server: Jira MCP Server

設定

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

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

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

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

サーバーの実行

サーバーを起動します。

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

ツールのテスト

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

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

MCPツール

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

リストモデル

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

応答例:

生成する

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

パラメータ:

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

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

例：

ファイルから生成

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

パラメータ:

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

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

例：

生成元URL

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

パラメータ:

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

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

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

例：

エラー処理

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

• 無効なAPIキー

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

• 入力が長すぎます

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

• URL 取得の失敗

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

• サーバーエラー

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

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

環境変数

• SPIRAL_API_KEY : Spiral APIキー（必須）

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

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

特徴

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

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

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

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

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

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