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编译器。 |