レイキャスト拡張をMCP互換クライアントにブリッジするMCPサーバー。

ローカルにインストールされている Raycast 拡張機能を発見し、ツールの定義をロードし、 stdio または HTTP 経由でモデルコンテキストプロトコルを経由して機能します。

使い方

1. [tools]の定義でインストールされた拡張子の[[~/.config/raycast/extensions/]をスキャン 2。 Raycastの暗号化されたSQLiteデータベースからOAuthトークンを読み込む 3。 MCP ツールとしてツールを MCP ツールとして登録します。

Raycast UI API(List]、[Detail]]、[Form]]など)を使用したエクステンションがサポートされています。UIコンポーネントはno-opsにシールドされ、ツールのロジックはヘッドレスに実行できます。 ツールがバックグラウンドワーク(API呼び出し、データ検索、変換)が最も効果的であるエクステンション。

セットアップ

前提条件

• バン
• 拡張機能搭載のレイキャスト
• [sqlcipher CLI (OAuth トークンアクセスの場合): [[brew install sqlcipher]

インストール

##MCP クライアントの設定

ロードコード (~/.claude/settings.json)):

カーソル ([[T8])):

##HTTP トランスポート

リモート MCP クライアントの HTTP サーバとしてサーバーを実行することもできます。

サーバの起動:

エンドポイント:

| エンドポイント | 方法 | 説明 | お問い合わせ

RayBridge

MCP server that bridges Raycast extensions to any MCP-compatible client.

Discovers locally installed Raycast extensions, loads their tool definitions, and serves them over the Model Context Protocol via stdio or HTTP.

How it works

1. Scans ~/.config/raycast/extensions/ for installed extensions with tools definitions
2. Loads OAuth tokens from Raycast’s encrypted SQLite database
3. Registers tools as MCP tools accessible to any MCP client

Extensions that use Raycast UI APIs (List, Detail, Form, etc.) are supported — the UI components are shimmed to no-ops so the underlying tool logic can execute headlessly. Extensions whose tools perform background work (API calls, data lookups, transformations) work best.

Setup

Prerequisites

• Bun
• Raycast installed with extensions
• sqlcipher CLI (for OAuth token access): brew install sqlcipher

Install

bun install

Configure MCP client

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "raybridge": {
      "command": "bun",
      "args": ["run", "src/index.ts"],
      "cwd": "/path/to/raybridge"
    }
  }
}

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "raybridge": {
      "command": "bun",
      "args": ["run", "src/index.ts"],
      "cwd": "/path/to/raybridge"
    }
  }
}

HTTP Transport

The server can also run as an HTTP server for remote MCP clients.

Start the server:

# Default: http://0.0.0.0:3000
bun run start:http

# Custom host/port
MCP_PORT=8080 MCP_HOST=0.0.0.0 bun run start:http

# With API key authentication
MCP_API_KEY=your-secret-key bun run start:http

# CLI flags also work
bun run src/index.ts --http --port 8080 --host 0.0.0.0

Endpoints:

Authentication:

When MCP_API_KEY is set, requests to /mcp must include a Bearer token (per MCP spec):

Authorization: Bearer your-secret-key

Example session:

# 1. Initialize session (capture session ID from response header)
curl -X POST http://127.0.0.1:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer your-secret-key" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
    "protocolVersion":"2024-11-05",
    "capabilities":{},
    "clientInfo":{"name":"my-client","version":"1.0"}
  }}'
# Response includes: mcp-session-id header

# 2. List available tools
curl -X POST http://127.0.0.1:3000/mcp \
  -H "Content-Type: application/json" \