MCP-Turso

mcp-turso

TursoがホストするLibSQLデータベースへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。現在、このサーバーは以下の機能を提供しています。

• データベース内のテーブルのリストを取得する
• データベースのスキーマの取得
• テーブルのスキーマを取得する
• SELECTクエリの実行

構成

クロード・デスクトップ

これをclaude_desktop_config.jsonに追加します:

続行するには既存のデータベースが必要です。データベースがない場合は作成してください。Turso CLI 経由でデータベース URL を取得するには、次のコマンドを実行します。

次に、データベース認証トークンを取得します。

上記のように、これらの値を構成に追加します。

カーソル付き

Cursor を使用して Turso MCP サーバーを構成するには、Cursor 設定に以下を追加します。

1. カーソルを開き、設定 (⚙️) > 設定 (JSON) に移動します。
2. 設定 JSON に次の構成を追加します。

前のセクションで説明したように、 your_urlとyour_tokenを Turso データベースの URL と認証トークンに置き換えます。

ログ記録

サーバーには、Claude Desktop 外部でのデバッグ用にカスタムロガーが含まれています。デフォルトでは、このロガーは<parent-dir>/logs/mcp-turso.logに書き込みます。ここで、 <parent-dir>はmcp-tursoスクリプトを含むディレクトリの親ディレクトリです。つまり、 mcp-tursoへのパスが~/foo/bin/mcp-tursoの場合、ログは~/foo/logs/mcp-turso.logに書き込まれます。上記のように NPX で実行している場合、デフォルトのログは次のようになります。

カスタム パスを指定する場合は、サーバーの構成に絶対 POSIX パスを含む--logsフラグを含めることができます。

ログファイルへのパス（デフォルトまたはカスタム）は、サーバー作成時に常にstderrに記録されます。Claudeデスクトップ版の場合、これは~/Library/Logs/Claude内のサーバーログに表示されます。

注: 現時点では、Windows 用のカスタム ログ ファイルの指定は実装されていませんが、今後実装される予定です。

サーバー機能

サーバーは次のツールを提供します。

• list_tables
  • データベース内のすべてのテーブルのリストを取得する
  • 入力なし
  • 戻り値: テーブル名の配列
• get_db_schema
  • データベース内のすべてのテーブルのスキーマを取得する
  • 入力なし
  • 戻り値: SQL作成ステートメントの配列
• describe_table
  • 特定のテーブルのスキーマ情報を表示する
  • 入力：
    • table_name (文字列): 記述するテーブルの名前
  • 戻り値: 名前と型を持つ列定義の配列
• query_database
  • SELECTクエリを実行してデータベースからデータを読み取ります
  • 入力：
    • sql (文字列): 実行するSELECT SQLクエリ
  • 戻り値: クエリ結果{ columns: string[]; rows: Record<string, unknown>[]; rowCount: number; }型のオブジェクトとして返します。

藤堂

• [ ] Windowsでカスタムログファイルを指定する機能を追加
• [ ] クエリツールを追加する

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。