基岩地方文档mcp
将文档目录索引到本地 兰斯数据库 使用Amazon Bedrock Titan嵌入的矢量存储，并使用两个工具将索引作为MCP服务器暴露给Claude Code： docs_search 和 docs_stats.
先决条件
- 紫外线 --依赖与环境管理
- AWS凭据 --所选区域中具有基岩通道的默认剖面
环境变量
在运行索引器或MCP服务器之前，必须设置所有变量。
| 变量 | 默认值 | 描述 |
|---|---|---|
AWS_REGION | -- | AWS区域，必须是 us-east-1 |
AWS_PROFILE | default | 要使用的AWS CLI配置文件 |
BEDROCK_EMBED_MODEL_ID | amazon.titan-embed-text-v2:0 | 基岩埋置模型 |
BEDROCK_EMBED_DIMS | 1024 | 嵌入尺寸 |
DOCS_DIR | -- | 要索引的根目录，例如。 ~/claude_docs |
INDEX_DIR | -- | LanceDB存储路径，例如。 ~/.local/bedrock_docs_lancedb |
TABLE_NAME | docs | LanceDB表名 |
构建指数
Makefile 目标从默认值设置所有环境变量（见上表），以及 调用索引器。根据需要覆盖命令行上的任何变量。
全面重建 --删除现有表并重新索引所有文档：
make index-rebuild增量更新 --附加尚未在索引中的文档（在后续运行中更快）：
make index-update要覆盖默认值，请内联传递变量：
make index-rebuild DOCS_DIR=/some/other/path索引器在完成时打印摘要行，例如： Indexed 42 files; added 187 chunks.
TLS配置
uv.toml 套 native-tls = true 以便uv对所有包使用操作系统信任存储 下载。这在公司防火墙后面是必要的。
MCP服务器
MCP服务器在中注册为用户范围的服务器 ~/.claude.json 并开始 当Claude Code启动时自动执行。初始操作后不需要手动操作 设置。
要验证服务器是否正在运行，请使用 /mcp 在Claude Code会话中-- bedrock-local-docs 应该显示为已连接。
可用工具
| 工具 | 说明 |
|---|---|
docs_search | 语义搜索；返回带有文件路径和摘录的前k个块 |
docs_stats | 返回行数、模型名称和嵌入维度 |