Sprites MCP Server

Sprites MCP 服务

Sprites 的官方 Model Context Protocol 服务——你可以通过 AI Agent 创建和运行沙盒化、可创建检查点的计算环境，在其中执行命令并管理服务。

这是一个远程 MCP 服务。你无需在本地安装或运行任何内容：MCP 客户端会通过 HTTPS 直接连接托管的端点，并使用 OAuth 进行身份验证。此仓库是该服务的公开主页，包含其清单、连接说明和工具参考。服务本身由 Fly.io 作为 Sprites 平台的一部分运营。

• 端点： https://sprites.dev/mcp
• 传输： Streamable HTTP（JSON-RPC 2.0）
• 身份验证： OAuth 2.1（sprites:read / sprites:write 作用域）
• 注册表： 官方 MCP 注册表中的 dev.sprites/mcp
• 文档： https://docs.sprites.dev/integrations/remote-mcp/

什么是 Sprites？

Sprite 是一个隔离的持久化计算环境。你可以通过编程方式创建环境、在其中执行命令、运行长时间运行的服务、将其完整状态保存为检查点并在之后恢复，还可以控制其出站网络策略。MCP 服务将这些功能作为工具提供，让 AI Agent 可以代表你操作 Sprites。

访问 sprites.dev 和 docs.sprites.dev 了解详情。

连接

由于这是一个远程服务，你只需将客户端指向该 URL，并在首次使用时通过浏览器完成 OAuth 登录。无需安装软件包，也无需运行本地进程。

Claude Code

claude mcp add --transport http sprites https://sprites.dev/mcp

然后在 Claude Code 中运行 /mcp，完成 OAuth 登录。

Cursor

点击上方的 将 sprites MCP 服务添加到 Cursor 按钮，或手动将其添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级）：

{
  "mcpServers": {
    "sprites": {
      "url": "https://sprites.dev/mcp"
    }
  }
}

Cursor 会在首次使用时提示你通过 OAuth 授权。

Claude Desktop / 其他原生支持 HTTP 的客户端

添加一个指向 https://sprites.dev/mcp 的远程服务。在支持远程服务的通用 MCP 客户端配置中，格式如下：

{
  "mcpServers": {
    "sprites": {
      "url": "https://sprites.dev/mcp"
    }
  }
}

首次使用时，系统会提示你通过 OAuth 授权。

仅支持 stdio 的客户端

一些较旧的 MCP 客户端只能通过 stdio 启动本地命令，无法直接连接 URL。对于这类客户端，通用适配器 mcp-remote 可以将 stdio 桥接到远程端点（并代你处理 OAuth 流程）：

{
  "mcpServers": {
    "sprites": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://sprites.dev/mcp"]
    }
  }
}

mcp-remote 是第三方现成工具，并非 Sprites 服务，而是为需要传输适配器的客户端提供的传输层桥接工具。

身份验证

该服务实现了 OAuth 2.1，并提供 MCP 客户端所需的元数据发现和动态客户端注册端点，因此大多数客户端在你提供 URL 后会自动完成配置：

端点	用途
GET /.well-known/oauth-protected-resource	受保护资源元数据（RFC 9728）
GET /.well-known/oauth-authorization-server	授权服务器元数据（RFC 8414）
POST /oauth/register	动态客户端注册（RFC 7591）
GET/POST /oauth/authorize	授权端点
POST /oauth/token	令牌端点

作用域： sprites:read（列出/获取操作）和 sprites:write（创建/更新/销毁及命令执行）。

受限令牌。 在授权流程中，你可以限制令牌——限定其可访问的 Sprite 名称前缀、限制可创建的 Sprite 总数、限定其适用的标签，或设置过期时间。每次调用都会执行这些限制。

工具

共 24 个工具，分组如下。访问权限为 read（安全，只读）或 write（创建、修改或执行）。每个作用于 sprite 的工具都需要一个 sprite 参数，用于指定目标 sprite。

Sprite 管理

工具	访问权限	描述
list_sprites	read	列出已验证组织的 sprite。
create_sprite	write	创建新的 sprite。
destroy_sprite	write	销毁一个 sprite。

命令执行

工具	访问权限	描述
exec	write	在 sprite 中运行命令（非 TTY HTTP exec）。
exec_list	read	列出活跃的 exec 会话。
exec_kill	write	按 ID 终止 exec 会话。

文件

读取和操作 sprite 文件系统中的文件。路径相对于 workingDir 解析，所有访问都限制在 sprite 的根目录内（会跟随符号链接，但不能越界）。

工具	访问权限	描述
file_read	read	读取文件内容。返回内嵌的文本或二进制资源。
file_list	read	列出目录中的条目。
file_write	write	将内容写入文件。
file_copy	write	复制文件或目录。
file_rename	write	重命名或移动文件或目录。
file_delete	write	删除文件或目录。

检查点

工具	访问权限	描述
checkpoint_create	write	创建当前 sprite 状态的快照。
checkpoint_list	read	列出检查点。
checkpoint_get	read	获取特定检查点的详细信息。
checkpoint_restore	write	将 sprite 恢复到某个检查点。

服务

工具	访问权限	描述
service_list	read	列出已配置的服务及其状态。
service_get	read	获取特定服务的详细信息。
service_create	write	创建或更新服务定义。
service_start	write	启动服务。
service_stop	write	停止正在运行的服务。
service_logs	read	流式传输服务日志。

网络策略

工具	访问权限	描述
policy_network_get	read	获取当前的出站网络策略。
policy_network_update	write	更新出站网络策略。

参数

通用：每个作用域为精灵的工具都需要 sprite（字符串）——目标精灵名称。

• list_sprites — prefix（字符串，可选）、max_results（整数，可选）、 continuation_token（字符串，可选）。
• create_sprite — name（字符串，必需）、wait_for_capacity（布尔值，可选）。
• destroy_sprite — name（字符串，必需）。
• exec — cmd（字符串，必需，可重复，用于命令和参数）、path（字符串， 可选）、stdin（布尔值，可选）、env（字符串 KEY=VALUE，可选，可重复）、 dir（字符串，可选）。
• exec_kill — session_id（字符串，必需）、signal（字符串，可选，默认值 为 SIGTERM）、timeout（字符串，可选，默认值为 10s）。
• file_read — path（字符串，必需）、workingDir（字符串，必需）、 encoding（字符串，可选，utf8（默认值）或 base64；utf8 返回嵌入式文本 资源，base64 返回嵌入式二进制资源）。
• file_list — path（字符串，必需）、workingDir（字符串，必需）。
• file_write — path（字符串，必需）、workingDir（字符串，必需）、 content（字符串，必需；utf8 为纯文本，base64 为经过 base64 编码的字节）、 encoding（字符串，可选，utf8（默认值）或 base64）、mode（字符串，可选，八进制 格式，例如 0644）、mkdir（布尔值，可选——创建父目录）。
• file_copy — source（字符串，必需）、dest（字符串，必需）、workingDir （字符串，必需）、recursive（布尔值，必需）、preserveAttrs（布尔值， 必需）、asRoot（布尔值，必需）。
• file_rename — source（字符串，必需）、dest（字符串，必需）、 workingDir（字符串，必需）、asRoot（布尔值，必需）。
• file_delete — path（字符串，必需）、workingDir（字符串，必需）、 recursive（布尔值，必需）、asRoot（布尔值，必需）。
• checkpoint_create — comment（字符串，可选）。
• checkpoint_get — checkpoint_id（字符串，必需，例如 v7）。
• checkpoint_restore — checkpoint_id（字符串，必需）。
• policy_network_update — rules（数组，必需；每条规则包含 domain、action 和可选的 include）。
• service_get / service_start / service_stop / service_logs — service_name （字符串，必需）。service_start/service_stop 接受可选的 duration/timeout； service_logs 接受可选的 lines（整数）和 duration（字符串）。
• service_create — service_name（字符串，必需）、cmd（字符串，必需）、 args（数组，可选）、needs（数组，可选）、http_port（整数，可选）、 duration（字符串，可选）。

权威且始终为最新版本的工具架构由在线服务通过 MCP tools/list 方法提供。

注册表与发现

此服务已作为 dev.sprites/mcp 发布到官方 MCP 注册表。自动接入该注册表的目录（Smithery、Glama、GitHub MCP 注册表等）会自动收录它。清单位于 server.json。

关于此存储库

此存储库仅包含公开目录的元数据和文档。MCP 服务作为 Sprites 平台的一部分实现，并在远程通过 https://sprites.dev/mcp 提供——此处没有可运行的服务端代码。

许可证

MIT © Fly.io, Inc.