AI导哈

开源项目文档管理服务器

VEPA-MCP是一个通用的MCP服务器，用于获取开源项目的最新文档、项目规范文件和页面模板文件，适用于开发者在LLM环境中减少幻觉。

  • by Heithon
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Heithon/VEPA-MCP

使用说明

VEPA-MCP

英语| 中文

一个为基于vue-element和admin的项目设计的MCP服务器，将组件文档、项目规范和模板文件集成到AI的上下文中。

VEPA-MCP现已成为适用于各种项目的通用MCP服务器。LLM可以使用此MCP获取指定开源项目的最新文档，并从指定目录读取规范和模板文件。它目前提供四种工具：

  • 解析库id：检索Context7 id。
  • 获取库文档：通过Context7 ID获取所需的项目文档。
  • 获取项目规范：从指定目录获取规范文档。
  • 获取页面模板：从指定目录获取页面模板文件。

获取最新文档的能力来自 Context7项目，可以搜索常见开源项目的最新文档。由于它将RAG应用于项目文档，因此它支持相对模糊的搜索，并可以检索多个高度相关的文档片段。我们可以将这些片段插入LLM的上下文中以减少幻觉。

安装

环境

  • Node.js>=v18.0.0
  • Cursor、Claude Code、VSCode、Windsurf或其他MCP客户端
  • Context7 API键-可选，但建议用于增加请求吞吐量。 (获取上下文API密钥)

该项目发布为 npm包，因此您可以使用以下命令调用该服务 npx。下面的示例显示了如何在Cursor中添加MCP服务器。

打开Cursor的MCP服务器设置： Settings -> Cursor Settings -> MCP -> Add new global MCP server

在此视图中，打开MCP JSON配置文件并粘贴以下代码段：

json{
  "mcpServers": {
    // ....
    "vepa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@silkide/vepa-mcp@latest"
      ]
    }
  }
}

其他支持MCP的平台也类似；有关平台特定的步骤，请参阅各自的文档。

环境变量和启动参数

vepa-mcp 提供了几个环境变量和CLI标志用于自定义：

  • CONTEXT7_KEY：设置Context7 API键。或者，通过启动标志进行配置 --key xxx.
  • CONTEXT7_TOKEN：控制Context7返回的默认令牌数。或者，通过配置 --token xxx （可能并不总是有效；LLM调用的工具可以提供自己的令牌限制）。
  • SPEC_DIR：项目规范文档的路径。默认为 project/contexts/spec.md。或者，通过配置 --spec-dir xxx.
  • PAGE_TEMP_DIR：页面模板目录的路径。默认为 project/contexts/template。或者，通过配置 --page-temp-dir xxx.

您可以在Cursor的MCP配置文件中设置启动参数和环境变量：

{
  "mcpServers": {
    // ....
    "vepa-mcp": {
      "command": "npx",
      "args": [
          "-y",
          "@silkide/vepa-mcp@latest",
          "--key xxx",
          "--spec-dir /xxx/xxx"
      ],
        "env": {
          "KEY": "value"
      }
    }
  }
}

规范文件

当LLM调用此MCP时，它将首先调用 get-project-specification 用于审查项目规范文档的工具。在规范中，建议指定此项目中使用的主要依赖关系和框架，并提前在 context7.com，包括规范中的这些ID。

您还可以在规范中指出LLM在阅读规范后应采取的下一步措施，使其更严格地遵守指令。您可以在项目中查看示例文档。/test/contexts/spec.md。

发展

克隆此项目并安装依赖项：

pnpm install

构建项目：

pnpm build

最终输出为 dist/index.js。您可以运行此脚本：

node dist/index.js

我们建议使用Kirigaya开发的VS Code MCP调试扩展： OpenMCP，这使得调试MCP服务非常方便。

您也可以使用官方 检查员 用于调试。

相关 MCP