代码检索工具包

Veil是一个面向编码代理的MCP优先检索工具包,提供本地代码检索、Git上下文、Web上下文和GitHub上下文的统一工具界面。

  • by ushiradineth
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ushiradineth/veil

使用说明

面纱代理工具包

Veil是MCP第一个用于编码代理的检索工具包。

它为本地代码检索、git上下文、web上下文和GitHub上下文提供了一个紧凑的工具界面。

设置

运行MCP服务器

npx -y @ushiradineth/veil@latest

安装MCP技能

npx -y skills add https://github.com/ushiradineth/veil --skill veil

MCP客户端配置

Codex
codex mcp add veil -- npx -y @ushiradineth/veil@latest
Claude Code
claude mcp add --scope user veil -- npx -y @ushiradineth/veil@latest
OpenCode

添加 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "veil": {
      "type": "local",
      "command": ["npx", "-y", "@ushiradineth/veil@latest"]
    }
  }
}

能力

能力 MCP工具
指标状态 veil_status
MCP和技能更新检查 veil_update_check
增量刷新 veil_refresh
全面重建 veil_build
发现文件/符号/块 veil_discover
按id获取一个块 veil_chunk
意图感知查找 veil_lookup
文件路径检索 veil_files
符号检索 veil_symbols
内容搜索 veil_search
语法列表/安装/删除/更新 veil_grammar_list, veil_grammar_install, veil_grammar_remove, veil_grammar_update
语法推荐/安装计划 veil_grammar_recommend
语法运行时包安装 veil_grammar_runtime_install
网络搜索 veil_web_search
获取URL veil_fetch_url
Git状态/日志/差异/显示 veil_git_status, veil_git_log, veil_git_diff, veil_git_show
GitHub上下文查找 veil_gh_lookup
诊断 veil_diagnostics

可选解析器运行时

  • 核心默认值保持在最低水平: javascript, typescript, json.
  • 其他语言是可选的,只有在用户明确批准后才能安装 veil_grammar_runtime_install.
  • 常见的可选保险范围包括:
    • nix, elixir, zig, go, rust
    • c, cpp, c-sharp
    • markdown
    • java, php, ruby, lua, kotlin, swift

运行时安装重用语义

  • 解析器启用或安装状态在中持久化 <state_root>/grammars.json (默认状态根: .veil).
  • 运行时包安装到 <state_root>/grammars-runtime 对于这个工作空间。
  • 当单独的MCP服务器实例针对相同的工作区时,它们会重用相同的运行时安装位置 州根。
  • 对于已知的可安装解析器,回退策略是严格的:只有在运行时安装为 记录为失败(runtime_install_failed)或者当不存在已知的运行时包映射时。

备注

Veil仍处于试验阶段,正在积极开发中。请报告任何问题或建议。