raycast

Raycast MCP サーバー

Raycast ワークフローを自動化する包括的な Model Context Protocol（MCP）サーバーです。Claude などの AI アシスタントと Raycast を連携する、強力な 9 種類のツールを提供します。

機能

🔧 包括的な 9 種類のツール

1. raycast_auth - Raycast およびサービスの認証を管理します
2. raycast_extensions - Raycast 拡張機能とストア連携を管理します
3. raycast_workflows - Raycast ワークフローと自動化を作成・管理します
4. raycast_search - Raycast を使ってアプリケーション、ファイル、コマンドを検索・起動します
5. raycast_clipboard - Raycast でクリップボードの履歴を管理します
6. raycast_shortcut - Raycast のショートカットとホットキーを実行します
7. raycast_window - Raycast のウィンドウ動作を制御します
8. raycast_system - Raycast を通じてシステム機能にアクセスします
9. その他のワークフローツール

🚀 機能

• 複数のサービスに対応した OAuth 連携
• 拡張機能の管理と公開ワークフロー
• カスタムワークフローの作成と実行
• システムの自動化と制御
• クリップボードの管理
• 検索とナビゲーション

インストール

Claude Desktop 経由

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "raycast": {
      "command": "node",
      "args": ["/path/to/raycast-mcp/dist/index.js"],
      "env": {
        "RAYCAST_API_KEY": "${RAYCAST_API_KEY}",
        "RAYCAST_TEAM_ID": "${RAYCAST_TEAM_ID}"
      }
    }
  }
}

NPX 経由（近日公開）

npx raycast-mcp-server

Smithery 経由

smithery install raycast-mcp-server

開発

前提条件

• Node.js 18+
• TypeScript
• macOS に Raycast がインストールされていること

セットアップ

git clone https://github.com/ExpertVagabond/raycast-mcp-server.git
cd raycast-mcp-server
npm install
npm run build

ローカルでの実行

npm start

本番環境向けのビルド

npm run build

使用例

認証の管理

# Setup GitHub authentication
{"tool": "raycast_auth", "arguments": {"action": "setup", "service": "github"}}

# Validate credentials  
{"tool": "raycast_auth", "arguments": {"action": "validate", "service": "github"}}

拡張機能の管理

# Search for extensions
{"tool": "raycast_extensions", "arguments": {"action": "search", "query": "github"}}

# List installed extensions
{"tool": "raycast_extensions", "arguments": {"action": "list"}}

ワークフローの自動化

# Create a custom workflow
{"tool": "raycast_workflows", "arguments": {
  "action": "create",
  "name": "morning-routine",
  "steps": [
    {"type": "command", "action": "open-calendar"},
    {"type": "api_call", "action": "fetch-weather"},
    {"type": "notification", "action": "daily-summary"}
  ]
}}

# Execute a workflow
{"tool": "raycast_workflows", "arguments": {"action": "execute", "name": "morning-routine"}}

環境変数

• RAYCAST_API_KEY - Raycast API キー（利用可能な場合）
• RAYCAST_TEAM_ID - Raycast チーム ID（該当する場合）

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 該当する場合はテストを追加します
5. プルリクエストを送信します

ライセンス

MIT

サポート

問題や機能リクエストについては、GitHub Issues ページをご利用ください。

---

Raycast と MCP のコミュニティのために ❤️ を込めて開発されました。