Raycast MCP 服务器

Raycast 工作流自动化的全面模型上下文协议（MCP）服务器，提供9种强大的工具，用于将Raycast与AI助手如Claude集成。

功能

🔧 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

使用示例

认证管理

# 设置GitHub认证
{"tool": "raycast_auth", "arguments": {"action": "setup", "service": "github"}}

# 验证凭据
{"tool": "raycast_auth", "arguments": {"action": "validate", "service": "github"}}

扩展管理

# 搜索扩展
{"tool": "raycast_extensions", "arguments": {"action": "search", "query": "github"}}

# 列出已安装的扩展
{"tool": "raycast_extensions", "arguments": {"action": "list"}}

工作流自动化

# 创建自定义工作流
{"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"}
  ]
}}

# 执行工作流
{"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社区打造，充满❤️。