ValTown MCP Server

ValTown MCP サーバー

ValTown 用の Model Context Protocol（MCP）サーバーです。 AI アシスタントが ValTown 環境でコードを実行できます。

機能

• AI アシスタントから ValTown 関数を実行できます
• すべての MCP クライアント（Claude Desktop、Claude Code など）に対応しています
• クロスプラットフォームに対応しています（Windows、macOS、Linux）

インストール

オプション 1：ビルド済みバイナリを使用する

お使いのプラットフォームに対応するバイナリを、 最新のリリースからダウンロードします。

• Linux：valtown-mcp-linux
• Windows：valtown-mcp-windows.exe
• macOS：valtown-mcp-macos

オプション 2：ソースからビルドする

1. Denoをインストールします
2. このリポジトリをクローンします
3. バイナリをビルドします：

   deno task build          # Builds for all platforms
   deno task build:linux    # Builds only for Linux
   deno task build:windows  # Builds only for Windows
   deno task build:macos    # Builds only for macOS
   

オプション 3：Deno で直接実行する

deno task start  # Run the server
deno task dev    # Run the server with watch mode for development

設定

サーバーを使用するには、ValTown API トークンが必要です。次の環境変数を設定してください。

• VAL_TOWN_API_TOKEN：ValTown API トークン（vtwn_で始まります）

ValTown API トークンは、 ValTown のアカウント設定から取得できます。

MCP クライアントでの使用

オンライン接続（ValTown でホスト）

この MCP サーバーを使う最も簡単な方法は、ValTown で実行されているホスト版に接続することです。

{
  "mcpServers": {
    "valtown": {
      "type": "streamable-http",
      "url": "https://prashamtrivedi-valtown-mcp-server.val.run/mcp",
      "headers": {
        "x-val-town-token": "YOUR_VAL_TOWN_TOKEN_HERE"
      }
    }
  }
}

YOUR_VAL_TOWN_TOKEN_HEREを実際の ValTown API トークンに置き換えてください。

ローカルインストール

サーバーをローカルで実行する場合は、次の方法を使用できます。

Claude Desktop

Windows の設定

次の内容を Claude Desktop の設定に追加してください。

"valtown": {
  "command": "C:\\path\\to\\valtown-mcp-windows.exe",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

macOS の設定

次の内容を Claude Desktop の設定に追加してください。

"valtown": {
  "command": "/path/to/valtown-mcp-macos",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Linux の設定

次の内容を Claude Desktop の設定に追加してください。

"valtown": {
  "command": "/path/to/valtown-mcp-linux",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Deno で実行する（すべてのプラットフォーム）

Deno がインストールされている場合は、サーバーを直接実行できます。

"valtown": {
  "command": "deno",
  "args": ["run", "--allow-net", "--allow-env", "--allow-read", "/path/to/mod.ts"],
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Claude Code

CLI を使用して、ValTown MCP サーバーを Claude Code に追加します。

claude mcp add valtown /path/to/valtown-mcp-linux -e VAL_TOWN_API_TOKEN=vtwn_KEY

Windows の場合は、次を使用します。

claude mcp add valtown C:\path\to\valtown-mcp-windows.exe -e VAL_TOWN_API_TOKEN=vtwn_KEY

macOS の場合は、次を使用します。

claude mcp add valtown /path/to/valtown-mcp-macos -e VAL_TOWN_API_TOKEN=vtwn_KEY

その他の MCP 対応クライアント

その他の MCP 対応クライアントでは、ValTown MCP サーバーのバイナリを指定するように設定し、VAL_TOWN_API_TOKEN環境変数が設定されていることを確認してください。

トラブルシューティング

• ValTown API トークンが有効であることを確認してください
• サーバーがネットワークにアクセスできることを確認してください
• バイナリに適切な権限が設定されていることを確認してください（Linux/macOS ではchmod +xが必要な場合があります）

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

変更履歴

このプロジェクトの主な変更点については、CHANGELOGを参照してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、 LICENSEファイルを参照してください。