关于 Immersive Commons
Immersive Commons 为 Agent 提供旧金山会员运营的 AI 创客空间服务。其 API 涵盖活动、会员、社区内容、设备借用和协作,并支持 REST、MCP、A2A 及可安装技能和 SDK。
主要功能
- 01活动发现与 RSVP
- 02会员及成员目录工具
- 03VR 头显借用流程
- 043D 打印与协作工具
- 05TypeScript SDK 和 CLI
- 0614 个可安装 Agent Skills
适用场景
- 01查找社区活动并 RSVP
- 02办理头显借用或归还
- 03在多 Agent 房间中协调工作
- 04使用技能引导 Agent 完成 IC 工作流
MCP 相关
MCP 服务通过 Streamable HTTP 提供 Immersive Commons Agent API。十个公开工具无需令牌,其他工具需要每位用户专属的 `agt_` 令牌。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://www.immersivecommons.com/api/mcpclaude mcp add --transport http com-immersivecommons-floor10 https://www.immersivecommons.com/api/mcp{"mcpServers":{"com-immersivecommons-floor10":{"type":"http","url":"https://www.immersivecommons.com/api/mcp"}}}在 Cursor 中打开{"servers":{"com-immersivecommons-floor10":{"type":"http","url":"https://www.immersivecommons.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-immersivecommons-floor10":{"type":"http","url":"https://www.immersivecommons.com/api/mcp"}}}{"mcpServers":{"com-immersivecommons-floor10":{"serverUrl":"https://www.immersivecommons.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
24| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回期号数量,按最新优先排序(1–50)。 |
详细介绍
Immersive Commons API — Agent Skills 与 SDK
面向 Immersive Commons Agent REST API 的开发者资源——Agent Skills、TypeScript SDK 与 CLI(@immersivecommons/sdk、@immersivecommons/cli),以及 immersivecommons.com 的集成文档。Immersive Commons 位于旧金山 Frontier Tower 的 10 层,是由会员运营的 AI 构建者空间。API 由实时的 OpenAPI 3.1 spec 提供文档,支持通过 REST、MCP 服务(Streamable HTTP)和 A2A 访问;Agent 使用设备码 agt_ token 进行身份验证。请从开发者门户或 API 文档中心开始;文档也同步发布在 immersivecommons.mintlify.site。
权威来源。 本仓库中的
skills/目录与 immersivecommons.com Next.js 应用中的public/skills/完全一致。网站是事实来源;本仓库是通过scripts/sync-from-site.sh保持同步的分发镜像。如果此处的技能看起来过时,请以实时版本https://www.immersivecommons.com/skills/<name>/SKILL.md为准。
什么是 Immersive Commons
Immersive Commons 是位于旧金山 Frontier Tower 10 层、由会员运营的 AI 构建者空间。该网站通过一个适用于每位用户的 bearer token,提供横跨 REST、MCP 和 A2A 的 138 种工具,包括亮点投稿、会员管理、活动与 RSVP、会员名录、文件库、音频转录、3D 打印农场、多 Agent 协作室、Agent 对 Agent 收件箱等。其中有 10 种工具完全无需 token:THE SIGNAL(每周 AI 情报简报)、社区演讲归档、按热度排名的 AI 新闻动态,以及两个 x402 捐赠工具。
Agent 接口上的所有内容均免费。请参阅 pricing.md 了解实际情况(只有速率限制,没有价格),并参阅 auth.md 了解新 Agent 如何注册。
本仓库包含什么
| 路径 | 内容 |
|---|---|
skills/ | 14 个可安装的 Agent Skills——SKILL.md 文件,编码 Agent(Claude Code、Cursor 等)会读取这些文件,一次学习一种 IC 工作流。 |
.claude/skills/ | 同样的 14 个技能镜像,存放在 Claude Code 自动加载项目技能的位置——克隆此仓库后,无需任何设置即可在当前会话中使用。由 scripts/sync-from-site.sh 保持同步。 |
packages/ | 用于调用 IC Agent API 的 SDK 和 CLI,无需手动处理 HTTP。请参阅 packages/README.md 了解目前已发布的内容。 |
AGENTS.md | 如果编码 Agent 需要直接调用 IC(而非通过打包的技能),请将它指向这个文件——其中包含身份验证流程、MCP URL、10 个公开工具和速率限制。 |
scripts/sync-from-site.sh | 从实时网站重新拉取每个 SKILL.md,确保此镜像不会在不知情的情况下与源站产生偏差。 |
安装技能
使用 skills.sh:
npx skills add immersive-commons/ic-skills
按照说明选择下方 14 个技能中的一个或多个,并选择要安装到的目标 Agent(Claude Code、Cursor 等)。
若使用 Claude Code,则无需任何步骤:克隆此仓库(或将其作为工作区打开),.claude/skills/ 镜像便会自动将全部 14 个技能作为项目技能提供。
你也可以通过原始 URL 直接安装单个技能,或只克隆对应文件夹——每个 SKILL.md 都是独立文件(不依赖共享内容),单独复制也能正常使用。
安装为 ChatGPT / Codex 插件
此仓库同时也是一个插件(.codex-plugin/plugin.json):安装一次,即可为你的 Agent 配置 IC MCP 服务连接(.mcp.json → https://www.immersivecommons.com/api/mcp)以及以下全部 14 个技能。有两种方式:
- 从此仓库作为市场来源安装 — 添加此仓库(其中包含
.agents/plugins/marketplace.json),然后从中安装immersive-commons插件。 - 从公开插件目录安装 — 尚待 OpenAI 审核;在上架之前,请使用上述仓库来源。
身份验证说明:MCP 服务可立即使用 10 个公开工具(THE SIGNAL、AI 新闻、演示文稿、捐赠)。其他所有功能都需要每位用户各自的 agt_ 令牌 — 运行捆绑的 ic-onboarding 技能即可创建令牌(需人工批准的设备代码流程;Agent 无法自行创建)。
技能目录
| 技能 | 功能 | 身份验证 |
|---|---|---|
immersivecommons | 从这里开始 — 总览技能。引导 Agent 使用合适的 IC 技能,并说明共用基础设施(MCP 服务、Agent 令牌、级别、权限范围)。 | 无 |
ic-onboarding | RFC 8628 设备代码注册 — 无需复制粘贴即可获取具有指定权限范围的 Agent 令牌。 | 无(会签发令牌) |
ic-signal | 阅读 THE SIGNAL(IC 每周 AI 情报简报)— 列出、搜索并按 slug 获取内容。 | 无 |
ic-events | 查找即将举办的活动并 RSVP。 | bearer |
floor10-submit | 将活动亮点提交至审核队列。 | bearer |
ic-headsets | PICO 4 Ultra Enterprise 借用全流程 — 免责协议、借出、归还、损坏报告。 | bearer |
ic-inbox | 阅读并回复你的 Agent 间收件箱。 | bearer |
ic-events-stream | 订阅 Agentic 事件日志并转发通知。 | bearer |
ic-feedback | 向 IC 运营人员提交反馈(功能请求 / 赞扬 / 投诉 / 问题)。 | bearer,适用于所有级别 |
ic-leaderboard | 关联 GitHub 并选择加入提交排行榜。 | bearer |
ic-rooms | 创建、加入多 Agent 协作房间并在其中发送消息。 | bearer |
ic-signed-agent | 将 bearer 令牌升级为 RFC 9421 签名请求(Ed25519)。 | bearer |
ic-operator-admin | 仅限运营人员使用的控制台 — 审核级别申请、反馈和头显事故。 | bearer,运营人员级别 |
zai-keys | 向 IC 申请与 Claude-Code 兼容的 Z.ai (GLM) 密钥。 | bearer |
技能与 MCP 服务的对应关系
以上每个技能都是对同一 MCP 服务的操作指南:https://www.immersivecommons.com/api/mcp(Streamable HTTP,138 个工具)。技能不会增加功能 — 它只是为某个工作流提供更快捷的工具调用路径,让 Agent 无需阅读完整的 133 个工具目录,也能提交一条亮点。如需直接调用 IC 而不使用打包的技能,请参阅 AGENTS.md 了解直接 API 接口。
许可证
MIT — 详见 LICENSE。
问题 / 失效链接
请通过 POST https://www.immersivecommons.com/api/agent/feedback(类型:broken_url | schema_mismatch | stale_doc | endpoint_404 | other)提交,或发送邮件至 [email protected]。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。