mcpField
S
symbols

symbols

本地服务
github.com/p1va开发工具514 周前更新
代码仓库

关于 symbols

Symbols MCP 通过连接语言服务器，为编码 Agent 提供代码符号的读取、检查和导航能力。它以精简的工具、资源和技能覆盖符号搜索、引用、调用关系及诊断等操作。

主要功能

  1. 01生成文件符号大纲
  2. 02检查符号文档与实现位置
  3. 03跨代码库搜索符号
  4. 04查找符号引用与调用关系
  5. 05重命名符号及获取诊断
  6. 06查看语言服务器状态与日志

适用场景

  1. 01探索代码库及其依赖
  2. 02定位符号声明和实现
  3. 03追踪调用关系与引用
  4. 04排查语言服务器配置和日志

MCP 相关

该 MCP 服务连接所选语言服务器，并向 MCP 客户端提供代码符号操作工具、语言服务器配置资源及相关技能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "p1va-symbols": {
      "command": "npx",
      "args": [
        "-y",
        "@p1va/symbols"
      ]
    }
  }
}
启动命令npx -y @p1va/symbols

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@p1va/symbols0.0.10

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Symbols MCP

通过连接语言服务器，读取、检查和导航代码库中的符号。

NPM Version

简介

通过连接选定的语言服务器，此 MCP 服务可帮助编码 Agent 轻松高效地探索和导航代码库及其依赖项。 该服务提供一组精简的工具、资源和技能，旨在易于使用，同时减少对模型上下文的占用。

工具
  • outline：返回文件中的代码符号大纲，可选择附带一小段代码片段
  • inspect：返回符号的文档、声明和实现位置，包括第三方符号
  • search：返回代码库中匹配的符号
  • references：查找代码库中符号的所有引用
  • call_hierarchy：返回可调用符号的传入和传出调用关系
  • rename：重命名代码库中符号的所有引用
  • diagnostics：返回指定文件中的有效诊断信息
  • completion：返回指定位置的上下文补全建议
  • reload：重新加载生效的配置，并将其重新应用于当前运行的语言服务器
资源
  • language-servers://profiles：返回已配置的语言服务器及其状态。
  • language-servers://profiles/{name}：返回一个语言服务器的详细信息。
  • language-servers://profiles/{name}/logs：返回语言服务器日志，以便排查问题。
技能
  • install-language-server：为当前工作区安装、配置、验证或排查语言服务器配置文件的问题。
  • language-server-navigation：指导你在退回到文本搜索之前，使用语言服务器工具检查符号、查找引用、重命名、查看诊断信息和搜索。

安装

Codex
codex plugin marketplace add p1va/symbols
codex plugin add symbols@symbols

然后向 Codex 提出请求：

Please install and configure the language servers relevant to this codebase

Antigravity
agy plugin install https://github.com/p1va/symbols.git

然后向 Antigravity 提出请求：

Install and configure the language servers relevant to this codebase.

手动安装

有关手动配置和语言服务器示例，请参阅此处。

开发

  • pnpm lint 输出 lint 违规项
  • pnpm lint:fix 尝试修复 lint 违规项
  • pnpm format 格式化代码库
  • pnpm format:check 检查格式，但不更改文件
  • pnpm dev 以开发模式启动
  • pnpm build 运行 linter 并构建
  • pnpm start 启动构建产物
  • pnpm test:unit 运行单元测试
  • pnpm test:integration:{language id} 运行指定语言的集成测试

发布

  • 使用 pnpm version patch 同步生成的资源、升级版本，并 创建单个提交和标签。适当时使用 minor 或 major。
  • 使用 git push --follow-tags 推送提交和标签。

版本生命周期会检查格式，将 .agents/skills/ 同步到 Antigravity 和 Codex 发行包，并在创建提交和标签之前更新带版本号的 Codex 插件 清单。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。