AI导哈

开发者上下文服务器

MCP服务器，提供项目上下文、代码库搜索、安全命令和API规范摘要功能，适用于任何模型或MCP客户端。

  • by AbdulRahmanMudasser
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AbdulRahmanMudasser/mcp-developer-context

使用说明

mcp开发者上下文服务器

显示任何模型或MCP客户端的项目上下文、代码库搜索、安全命令和API规范摘要的MCP服务器

先决条件

  • Node.js 20或更高版本

安装

git clone 
cd mcp-developer-context-server
npm install

配置

可选环境变量：

变量 描述
PROJECT_ROOT 目录被视为项目根目录。默认为进程工作目录。
ALLOWED_COMMANDS 运行命令工具允许的命令列表，以逗号分隔。如果未设置，则使用默认列表（例如。 npm run lint, npm run typecheck, npm test, npx tsc --noEmit).

跑步

构建并启动服务器：

npm run build
npm start

对于没有建筑的开发：

npm run dev

服务器通过stdio运行并等待客户端连接。按Ctrl+C停止。

MCP检验员测试

在MCP检查器下运行服务器以行使所有功能：

npm run build
npm run inspector

打开http://localhost:6274在浏览器中。使用“工具”、“资源”和“提示”选项卡调用功能并验证响应。

工具：预期行为

工具 示例输入 预期结果
搜索代码库 模式： registerTool，glob： **/*.ts 表格的线条 path:lineNum: snippet 用于匹配文件；忽略 node_modules 和 dist.
项目结构 （无）或深度： 1 目录树和根目录下列出关键文件的行（例如package.json、tsconfig.json）。
运行命令 command： npm run lint 退出代码并命令stdout/stderr。
运行命令 command： echo hello 消息：“不允许命令。”
fetch api spec url:一个有效的OpenAPI JSON url 摘要，包含操作（方法、路径、操作ID）和模式名称。
验证json json: {"a":1}，行动： format 打印精美的JSON。
验证json json: {invalid，行动： validate 错误消息：“JSON无效”和解析详细信息。

资源：预期行为

资源URI 预期结果
project://manifest 项目的JSON正文 package.json.
project://config JSON格式 configFiles （例如tsconfig.json、package.json）和 envExampleKeys 从 .env.example 如果存在。
api://spec 请求的消息 url 查询参数。
api://spec?url= 摘要格式与fetch-api规范工具相同。

提示：预期行为

提示 示例参数 预期结果
代码审查 代码：代码片段，焦点： performance 或空 包含审核说明和提供的代码的单用户消息。
api用法 操作ID:例如。 getPets，language:可选 请求该操作的客户端示例的单用户消息。
测试计划 模块：例如。 src/index.ts，entryPoints：可选 请求模块单元测试建议的单用户消息。

光标设置

将服务器添加到您的Cursor MCP配置中（例如在Cursor设置或配置的MCP配置文件中）：

{
  "mcpServers": {
    "developer-context": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-developer-context-server/dist/index.js"],
      "env": {
        "PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

用实际的项目和服务器位置替换路径。重新启动或重新加载Cursor，使其拾取服务器。

项目结构

src/
  index.ts          Server entry; registers tools, resources, prompts; stdio transport.
  lib/              Shared helpers: project root, manifest read, OpenAPI summary.
  tools/            MCP tools: search-codebase, project-structure, run-command, fetch-api-spec, validate-json.
  resources/       MCP resources: project manifest, project config, API spec.
  prompts/         MCP prompts: code-review, api-usage, test-plan.

脚本

脚本 目的
npm run build 将TypeScript编译为 dist/.
npm start 运行已编译的服务器。
npm run dev 使用tsx从源代码运行服务器。
npm run inspector 在MCP检查器下运行服务器(http://localhost:6274).
npm run lint 在上运行ESLint src/.
npm run typecheck 在仅检查模式下运行TypeScript编译器。

相关 MCP