内容
Extentos MCP 服务器
[](https://www.npmjs.com/package/@extentos/mcp-server)
[](./LICENSE)
**为您的 AI 编程代理提供工具，以便构建智能眼镜应用。**
Extentos 是一个 MCP（模型上下文协议）服务器，允许像 Claude Code、Cursor 和 Cline 这样的代理为任何 Android 或 iOS 应用添加智能眼镜功能 — 摄像头捕捉、语音触发、实时转录、音频播放。 这些工具是确定性的：发现、脚手架、验证和基于浏览器的模拟器，用于端到端测试，无需硬件。
目前与 Meta 智能眼镜合作（Ray-Ban Meta、Oakley Meta、Meta Ray-Ban Display），采用多供应商架构设计。
本仓库是 [`@extentos/mcp-server`](https://www.npmjs.com/package/@extentos/mcp-server)主页 — 版本发布、变更日志和问题跟踪。 该软件包在 npm 上发布。
## 安装
**Claude Code**
```bash
claude mcp add extentos -- npx -y @extentos/mcp-server@latest
```
**Cursor** — 一键安装：
[](cursor://anysphere.cursor-deeplink/mcp/install?name=extentos&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSBleHRlbnRvcy9tY3Atc2VydmVyQGxhdGVzdCJdfQ==)
**Cline / 任意 MCP 客户端**
```json
{
"mcpServers": {
"extentos": {
"command": "npx",
"args": ["-y", "@extentos/mcp-server@latest"]
}
}
}
```
需要 Node 20+。
## 代理可以使用该工具的功能
| 工具组 | |
|---|---|
| **发现** | `getPlatformInfo`、`getCapabilityGuide`、`getCodeExample` — SDK 功能目录、每个功能的调用形式（Kotlin + Swift）以及规范的端到端模式（语音问答、照片描述、实时转录 UI 等） |
| **脚手架** | `generateConnectionModule` — 为您的应用（Android 或 iOS）生成连接 UI + 清单 + 平台配置 |
| **指导** | `getVoiceCommandGuidance`、`getPermissions` — 实现指导，代理查询而不是猜测 |
| **验证** | `inspectIntegration`、`validateIntegration` — 仓库中集成的确定性检查 |
| **模拟** | `createSimulatorSession`、`getEventLog`、`getSimulatorStatus` — 基于浏览器的模拟器，运行与生产环境相同的 SDK 代码，仅更换传输方式；代理驱动它并读取事件日志以验证行为 |
| **生产** | `getProductionChecklist`、`getCredentialGuide` — 从模拟器到真实眼镜的路径 |
| **文档** | `searchDocs` — 捆绑的、版本化的文档主题 |
代理通常运行的工作流程：发现功能 → 脚手架连接模块 → 编写针对 SDK 的处理程序代码 → 验证 → 模拟端到端 → 生产检查清单。
## 工具
- **getPlatformInfo** — SDK 功能目录、版本/工件信息和平台约束
- **getCapabilityGuide** — 每个功能的调用形式（Kotlin + Swift），附带注意事项
- **getCodeExample** — 规范的端到端模式（语音问答、照片描述、实时转录 UI 等）
- **getMigrationGuide** — 从 Meta DAT 直接使用到 Extentos 的映射表和切换计划
- **generateConnectionModule** — 为您的应用脚手架连接 UI、清单和平台配置
- **getConnectionPageConfig** — 读取托管的连接页面配置
- **setConnectionPageConfig** — 更新托管的连接页面配置
- **regenerateConnectionPageFile** — 在配置更改后重新生成托管的连接页面文件
- **adoptConnectionPageFile** — 将现有的连接页面文件纳入托管配置
- **getAssistantConfig** — 读取托管的语音助手配置（模型、语音、内存、唤醒声音）
- **setAssistantConfig** — 更新托管的语音助手配置
- **listProjectSounds** — 列出为项目上传的自定义声音
- **addProjectSound** — 为项目上传自定义声音（声音图标、唤醒声音）
- **shutter** — 在活动模拟器会话中触发摄像头快门
- **getGateway — 项目的 AI 网关使用情况和计量
- **getCredentialStatus** — 配置了哪些凭证（Meta DAT、AI 提供商）
- **setCredential** — 为项目存储凭证
- **getProjectAnalytics** — 项目的眼镜集成使用情况分析
- **getVoiceCommandGuidance** — 语音触发器和唤醒短语的实现指南
- **getPermissions** — 集成上需要的确切权限集
- **inspectIntegration** — 读取仓库中集成的当前状态
- **validateIntegration** — 集成（清单、配置、线路）的确定性检查
- **createSimulatorSession** — 为端到端测试创建基于浏览器的模拟器会话
- **ensureSimulatorBrowser** — 为会话打开/附加模拟器浏览器选项卡
- **completeAuthLink** — 完成设备代码登录流程
- **getEventLog** — 读取会话事件日志（传输、音频、摄像头、讲话、切换、流、系统）
- **injectTranscript** — 将语音转录注入的应用，好像佩戴者正在讲话
- **injectAssistantUtterance** — 使用语音助手驱动语音utterance端到端（真实提供者会话）
- **assertToolCalled** — 等待匹配名称/参数的助手工具调用事件（代理 E2E 环路）
- **getSimulatorStatus** — 实时会话状态：阶段、角色、打开的流、新鲜度、测试视频
- **setSimVideo** — 将测试视频传输到模拟摄像头
- **setSimDevice** — 切换模拟眼镜模型
- **getDisplayState** — 读取渲染的显示树和交互元素 ID（Ray-Ban Display）
- **injectInput** — 驱动显示输入：选择/导航/返回，如 Neural Band 手势
- **injectHardwareButton** — 模拟硬件捕捉按钮
- **getProductionChecklist** — 从模拟器到真实眼镜的路径
- **getCredentialGuide** — 如何获取和配置 Meta DAT 凭证
- **searchDocs** —捆绑的、版本化的文档主题
## 它如何组合
- 您的应用依赖于原生 SDK：[`com:glasses`](https://central.sonatype.com/entos/glasses)（Android，Maven Central）或（iOS）
- 您的代码从其自己的处理功能原语 — `glasses.audio.transcriptions()`、`glasses.camera.capturePhoto()`、`glasses.audio.speak()`
模拟器是同一个应用在不同基板上的版本： 传输代替蓝牙，因此代理验证的行为适用于硬件
和指导工具匿名工作。 创建基于浏览器的模拟器会话和脚手架需要一个免费帐户 — 服务器在需要设备代码登录引导代理（和您）。
## - [文档](https://extentos.com/docs)
- [入门](https://extentos.com/docs/getting-started/with-agent [MCP 工具参考](https://extentos.com/docs/reference/mcp-tools)
- [智能眼镜生态系统参考extentos.com/docs/ecosystem)
## 问题和反馈
欢迎报告错误和反馈 — [打开一个问题](https:///extentos/mcp-server/issues)。 该软件包是预 1.0 版本；工具表面可能在小版本之间演变。
有关安全报告，请参阅 [SECURITY.md](./SECURITY.md) — 请不要为漏洞打开公共问题。
## 许可证
[MIT](./LICENSE)
