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. 进入管理 MCP 服务命令，按 Cmd + N
4. 将 JSON 粘贴到文本框中。确保修改任何需要更改的字段，包括 API 密钥或在本例中允许的目录。提交表单。
5. 你的服务已准备就绪！

在服务列表中，你应该能够看到你的新服务及其使用的服务。在我们的案例中，它会显示"使用 npx"

继续阅读了解如何通过直接修改配置文件来添加服务或编写你自己的服务。

或者，跳到底部的_在 Raycast AI 中使用 MCP 服务_，了解有关在 Raycast AI 中使用 MCP 的信息。

修改配置文件

所有非开发服务都存储在扩展程序支持目录中名为 mcp-config.json 的单个配置文件中。它遵循与 Claude 桌面应用程序的 MCP 配置文件类似的模式。

你可以通过进入管理 MCP 服务命令并选择在 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 会为你自动编辑，但这对于修改可能更容易。

添加本地/开发服务

你也可以为自己的自定义服务编写代码。首先在服务文件夹中创建一个新子文件夹。你可以通过进入管理 MCP 服务命令，然后使用打开服务文件夹操作来找到此文件夹。请注意，这是 mcp-config.json 所在的文件夹。

在你的新子文件夹中，你应该在 index.js 文件中编写正确的 MCP 服务代码。Raycast MCP 扩展程序将在下次运行时自动检测到它。

有关服务应该是什么样子的灵感，请参阅 MCP GitHub 中的示例，了解 filesystem 扩展。

请注意，目前仅支持 JS，因此你应该用 JS 编写。确保你在文件夹中有 package.json。如果你还没有运行 npm install，扩展程序会自动为你运行。

在 Raycast AI 中使用 MCP 服务

只要你安装了正确的服务，你就可以通过使用 @mcp 前缀调用 Raycast AI 来使用任何 MCP 工具。

扩展程序会自动向 Raycast AI 显示所有可用的服务，Raycast AI 会选择并使用适当的工具。无需额外设置！