内容
# 全景上下文
将 Claude 连接到您的生活 — 无需接触终端。
<!-- INSERTA AQUÍ EL GIF DE DEMOSTRACIÓN -->
[](LICENSE)
全景上下文是一款适用于 Claude Desktop 的本地 MCP 服务器，它将 Claude 连接到您已经使用的工具 — 目前支持 Notion 和 YouTube，未来还会有更多。只需安装一个一键式扩展程序，无需终端或 API 控制台。
```
您： 请为我总结这个视频：youtube.com/watch?v=xxxxxxxxxxx
Claude：[通过全景上下文读取转录内容并立即回复]
您： 我的 Notion 页面“Q3 路线图”中关于发布日期的内容是什么？
Claude：[搜索您的 Notion，打开页面，从其内容中回答]
```
---
## 功能
- **Notion，无需复制粘贴** — 搜索页面标题并直接从对话中提取完整的页面内容，以 Markdown 格式显示。
- **YouTube 视频，粘贴链接即可** — Claude 读取转录内容，可以立即总结、分析或回答问题。
- **干净的转录导出** — 当您需要原始文本（用于笔记、研究或其他工具）时，全景上下文将其保存为整洁的 `.md` 文件，而不是将其转储到聊天中。
更多集成正在开发中 — 请查看 [路线图](#路线图)。
---
## 安装
无需代码，无需终端，无需 API 控制台。
1. 从 [发布](#releases) 选项卡下载最新的 `omnicontext.mcpb` 文件。
2. 打开 Claude Desktop → 菜单（☰）→ `文件 → 设置 → 扩展程序`。
3. 点击高级设置，然后滚动到底部，点击 *安装扩展程序…* 并选择它。
4. 如果您正在使用 Notion，请将您的集成令牌粘贴到 Claude Desktop 显示的表单中。这就是整个设置过程。
5. 在聊天中试用：
- “这个 YouTube 视频是关于什么的：`<link>`”
- “阅读我的 Notion 页面：`<link>`”
注意：您的 Notion 令牌由您的操作系统（macOS 上的 Keychain，Windows 上的 Credential Manager）加密存储 — 绝不会存储在纯文本文件中。如果您不需要 Notion，可以跳过它；YouTube 工具无需设置即可使用。
---
## 开发
从源代码运行服务器、贡献或将其连接到 Claude Code 而不是 Claude Desktop。
```bash
git clone <your-repo-url>
cd omnicontext
npm install
npm run build # 编译 TypeScript -> dist/
npm test # 完整的测试套件，包括实时烟雾测试
npm run pack # 在本地构建 omnicontext.mcpb
```
在 Claude Code 中注册：
```bash
claude mcp add --transport stdio omnicontext \
--env NOTION_TOKEN=your_notion_token \
-- node /absolute/path/to/omnicontext/dist/index.js
```
在开发过程中直接运行：
```bash
npm run dev
```
使用官方 [MCP 检视器](https://github.com/modelcontextprotocol/inspector) 调试工具调用：
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
### 工具参考
| 工具 | 功能 |
|---|---|
| `notion_get_page` | 读取 Notion 页面（URL 或 ID）并将其作为 Markdown 返回 |
| `notion_search` | 在所有与集成共享的页面中搜索页面标题 |
| `youtube_get_transcript` | 获取 YouTube 视频的转录内容作为纯文本，用于聊天分析 |
| `youtube_save_transcript` | 将视频的完整转录内容保存到本地 `.md` 文件 |
---
## 路线图
全景上下文是一个早期的 MVP — 基础已经完成，集成列表才刚刚开始。
- [x] YouTube 转录内容（聊天中 + 文件导出）
- [x] Notion（内部令牌，只读）
- [x] 适用于 Claude Desktop 的一键式 `.mcpb` 打包
- [ ] Notion OAuth — 一键连接，无需手动令牌或手动共享页面
- [ ] Discord 集成
- [ ] Telegram 集成
- [ ] 更多集成，一个上下文源一个
---
## 隐私与安全
全景上下文完全在您的机器上运行。它直接与 Notion 和 YouTube 的 API 通信 — 没有全景上下文后端，没有分析，也没有中间服务器看到您的数据。
---
## 贡献
欢迎提出问题和拉取请求。如果您要添加新的集成，请遵循 `src/integrations/<name>/` 中现有的模式 — 每个集成都是自包含的，并注册其自己的工具而无需触及核心服务器。
## 支持
发现了错误或想请求集成？[打开一个问题](../../issues)。
---
## 许可证
[MIT](LICENSE) — 免费使用、修改和自行托管。
---
基于 [模型上下文协议](https://modelcontextprotocol.io) 构建。
