atproto-mcp
数据源
| 来源 | 存储库 | 描述 |
|---|---|---|
| AT协议网站 | bluesky社交网站/atproto | 来自atproto.com的协议规范、指南和博客文章 |
| 蓝天API文档 | bluesky social/bsky docs | docs.bsky.app中的开发人员文档--教程、指南、高级主题 |
| AT协议词典 | bluesky social/atproto | 定义所有AT协议端点和记录类型的JSON模式 |
| 烹饪书 | bluesky社交/烹饪书 | Python、Go、TypeScript和JavaScript中的示例项目 |
工具
| 工具 | 说明 |
|---|---|
search_atproto_docs | 跨所有文档源的语义搜索 |
get_lexicon | 通过NSID检索特定词典（例如。 app.bsky.feed.post) |
list_lexicons | 列出所有词典，可选择按命名空间筛选 |
search_lexicons | 词典模式中的语义搜索 |
get_cookbook_example | 按项目名称获取特定的烹饪书示例 |
list_cookbook_examples | 列出所有烹饪书示例，可选择按语言列出 |
search_bsky_api | Bluesky API文档中的语义搜索 |
refresh_sources | 强制重新获取存储库并重建索引 |
提示
| 提示 | 描述 |
|---|---|
explain_lexicon | 获取词典的全面解释 |
implement_feature | 通过代码示例获取实施指南 |
debug_atproto | 帮助调试AT协议/Bluesky API问题 |
explore_namespace | 探索命名空间中的所有词典 |
安装
先决条件
- Python 3.10+
- 紫外线 （推荐）或pip
- Git（用于克隆源代码仓库）
从源代码安装
git clone https://github.com/ashex/atproto-mcp.git
cd atproto-mcp
uv sync用uvx跑步
uvx atproto-mcp配置
VS代码/副本
增添 .vscode/mcp.json 在您的工作空间中：
{
"mcpServers": {
"atproto": {
"command": "uvx",
"args": [
"atproto-mcp"
]
}
}
}基洛电力
- 打开 Kiro → 权力
- 选择 从GitHub导入电源
- 进入
https://github.com/ashex/atproto-mcp
克劳德桌面
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"atproto": {
"command": "uvx",
"args": [
"atproto-mcp"
]
}
}
}MCPHub
增添 ~/.config/mcphub/servers.json:
{
"mcpServers": {
"atproto": {
"command": "uvx",
"args": ["atproto-mcp"]
}
}
}开源代码
添加到您的 opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"atproto": {
"type": "local",
"command": ["uvx", "atproto-mcp"]
}
}
}环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
ATPROTO_MCP_CACHE_DIR | ~/.cache/atproto-mcp | 存储仓库和搜索索引的位置 |
ATPROTO_MCP_REFRESH_HOURS | 24 | 重新获取存储库前几个小时 |
ATPROTO_MCP_EMBEDDING_MODEL | sentence-transformers/all-MiniLM-L6-v2 | 嵌入语句变换器模型 |
运作原理
首次启动时，服务器：
- 浅层克隆repos
~/.cache/atproto-mcp/repos/ - 将MDX文档、词典模式和烹饪书示例解析为文本块
- 使用txtai对块进行索引
all-MiniLM-L6-v2句子转换器模型（~80MB，本地运行） - 索引被持久化
~/.cache/atproto-mcp/index/用于后续启动
在随后的启动中，缓存的索引会在几秒钟内加载。超过24小时的存储库将自动刷新 git pull.
发展
# Install in development mode
uv sync
# Run the server locally (stdio)
uv run atproto-mcp
# Test with the MCP Inspector
uv run mcp dev src/atproto_mcp/server.py
# Run with debug logging
ATPROTO_MCP_CACHE_DIR=/tmp/atproto-mcp uv run atproto-mcp许可证
麻省理工学院