内容
# 本地音频桩
地理位置固定的语音笔记，将生活体验与坐标绑定 — 并通过MCP将其暴露给AI。
## 为什么存在
地图上充满了数据，但缺乏上下文。评论优化了评分；维基优化了事实。两者都无法捕捉到只有在现场才能产生的知识：“光线在这个角落完美地照射在下午5点”，“下雨后避免走这条路”，“这是我奶奶曾经等公交车的地方”。
本地音频桩将**地点作为一等公民的上下文窗口** — 适用于人类导航空间，也适用于模型推理。
## 功能
1. 点击地图位置 → 录制短音频笔记 → 保存为地理桩
2. 在共享的收藏页面上浏览和播放桩
3. 通过MCP服务器（只读）将相同的数据暴露给Claude
## 架构
```
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ 浏览器 │ │ Next.js │ │ 文件系统 │
│ │ │ │ │ │
│ MapLibre │ │ POST /pins │ │ data/ │
│ 点击 → 坐标 │────▶│ GET /collection│────▶│ collections.json
│ │ │ GET /pins │ │ audio/*.webm │
│ MediaRecorder │ │ GET /audio/:id │ │ │
│ 麦克风 → .webm │ │ │ └────────┬─────────┘
│ │ └──────────────────┘ │
│ <audio> │ │
│ 流媒体播放 │ ▼
└──────────────────┘ ┌──────────────────┐
│ MCP 服务器 │
│ （只读） │
│ │
│ 获取收藏 │
│ 列出桩 │
│ 获取桩 │
│ │
│ ↳ 暴露给 │
│ Claude │
└──────────────────┘
```
**零外部依赖。** 没有数据库，没有云存储，没有API密钥。所有内容都存放在 `data/` 中。
## 自己运行
```bash
git clone https://github.com/Shaandjain/local-audio-pins.git
cd local-audio-pins
npm install
npm run dev
```
打开 `http://localhost:3000`，点击地图，录制笔记。
## MCP 服务器
MCP服务器将您的音频桩暴露给Claude，使基于位置的录音的AI查询成为可能。
### 设置
```bash
cd mcp-server
npm install
```
### 连接到Claude Desktop
将以下内容添加到Claude Desktop配置中（`~/Library/Application Support/Claude/claude_desktop_config.json` 在macOS上）：
```json
{
"mcpServers": {
"local-audio-pins": {
"command": "node",
"args": ["/path/to/local-audio-pins/mcp-server/index.js"]
}
}
}
```
更新配置后重启Claude Desktop。
### 示例提示
连接后，尝试询问Claude：
- **"列出收藏中的所有桩"** — 获取所有音频笔记的概览
- **"从最东边的点开始创建从这些桩的步行游览"** — 生成位置感知的行程
- **"哪些桩提到食物或餐厅？"** — 在您的桩描述中搜索
- **"哪个桩最接近市中心？"** — 对您的数据进行空间查询
- **"总结每个位置的内容"** — 从您的录音中获取见解
## 许可证
MIT
