raycast

Raycast MCP 服务

功能全面的 Model Context Protocol（MCP）服务，用于自动化 Raycast 工作流，提供 9 种强大工具，可将 Raycast 与 Claude 等 AI 助手集成。

功能

🔧 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. Fork 此仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

许可证

MIT

支持

如需反馈问题或申请功能，请使用 GitHub Issues 页面。

---

为 Raycast 和 MCP 社区倾情打造 ❤️