Model Context Protocol for Raycast

Raycast 用 Model Context Protocol

Raycast AI で Anthropic の Model Context Protocol を使用しましょう！

MCP サーバーをインストールして、Quick AI または AI Chat で直接ツールを使用できます。

ドキュメント

サーバーを追加する方法と、サーバーを使用する方法について説明します。

UI 経由でサーバーを追加する

1. ダウンロードするサーバーを見つけます。例として filesystem サーバー を使用しましょう
2. サーバーのドキュメントで、Claude デスクトップ設定に追加するコードを見つけます。JSON の内部セクションのみをコピーして、トップレベルのキーがサーバーの名前になるようにしてください。次のようになります：

{
  "filesystem": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-filesystem",
      "/Users/username/Desktop",
      "/path/to/other/allowed/dir"
    ]
  }
}

3. Manage MCP Servers コマンドに移動して、Cmd + N を押します
4. JSON をテキストボックスに貼り付けます。API キーや、このケースでは許可するディレクトリなど、変更が必要なフィールドを必ず修正してください。フォームを送信します。
5. サーバーは使用可能な状態になりました！

サーバーのリストで、新しいサーバーとそれが使用するサービスを確認できます。この場合、「Uses npx」と表示されます

設定ファイルを直接編集してサーバーを追加する方法、または独自のサーバーをコードする方法について詳しく学びましょう。

または、下部の「Raycast AI で MCP サーバーを使用する」にスキップして、Raycast AI で MCP を使用する方法について確認してください。

設定ファイルを編集する

すべての非開発サーバーは、Extension のサポートディレクトリにある mcp-config.json という単一の設定ファイルに格納されます。これは Claude のデスクトップアプリの MCP 設定ファイルと同様のパターンに従います。

Manage MCP Servers コマンドに移動し、Show Config File in Finder アクションを選択することで見つけられます。デフォルトでは次のようになります（コメント部分は含まれません）：

{
  "mcpServers": {
    // Server JSON here
  }
}

mcpServers JSON では、すべてのサーバーを追加できます。例えば、sequential-thinking と filesystem を使用した場合は次のようになります。

{
	"mcpServers": {
		"sequential-thinking": {
			"command": "npx",
			"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
		},
		"filesystem": {
			"command": "npx",
			"args": [
				"-y",
				"@modelcontextprotocol/server-filesystem",
				"/Users/evan/Desktop"
			]
		}
	}
}

UI を使用するとこの編集が自動的に行われますが、この方法はより簡単に修正できます。

ローカル / 開発サーバーを追加する

カスタムサーバーのコードを記述することもできます。まず、Servers フォルダに新しいサブフォルダを作成します。このフォルダは、Manage MCP Servers コマンドに移動して、Open Servers Folder アクションを使用することで見つけられます。これは mcp-config.json が格納されているフォルダと同じです。

新しいサブフォルダでは、index.js ファイルに正しい MCP サーバーコードを記述してください。Raycast MCP extension は次回実行時に自動的にそれを検出します。

サーバーがどのような形式である必要があるかの参考として、MCP GitHub の例（filesystem extension）を参照してください。

現在のところ JS のみがサポートされているため、JS で記述してください。フォルダに package.json があることを確認してください。npm install を実行していない場合、extension が自動的に実行します。

Raycast AI で MCP サーバーを使用する

正しいサーバーがインストールされていれば、@mcp プレフィックスで Raycast AI を呼び出すことで、MCP ツールを使用できます。

Extension は自動的に Raycast AI に利用可能なサーバーをすべて表示し、Raycast AI が適切なツールを選択して使用します。追加のセットアップは不要です！