MCP 项目标准管理服务器

一个基于 MCP（Model Context Protocol）协议的项目标准管理工具，专为 AI 辅助开发而设计，帮助团队在多台机器上保持统一的开发标准和规范。

💡 高效实践

通过配置 工具提示词，要求模型在每次修改前先查看项目规范：

注册账号：
- 🇨🇳 国内：https://openai.hlwidc.com:28080/user
- 🌐 海外：https://www.zhineng.dev/user/
添加自己的厂商和模型配置
生成 API 密钥
在密钥的 工具提示词 中添加：

工具名：development_standards
提示词：请先使用development_standards工具看下规范再去编辑修改

效果：模型在每轮修改前会先查看规范，确保代码符合团队标准，同时会消耗少量额外 token。

�🚀 核心优势

💰 Token 成本优化

高效 Context Caching：通过 MCP 工具获取短小、结构化的标准数据而非读取冗长文档，能更有效地触发模型的 Context Caching（上下文缓存，如 Gemini 3 Flash），将输入成本降低至极低水平（约 $0.05/1M）。
增量式输出：强制执行最小化代码 Diff 和精简的工具响应，最大限度减少高昂的输出 Token 消耗。

🎯 解决多机器开发混乱问题

统一标准：多台机器上的 AI 助手使用相同的项目标准，避免开发风格不一致
团队协作：消除因不同开发者使用不同 AI 配置导致的代码风格差异

🛡️ 企业级开发规范管理

项目信息管理：统一管理项目基本信息、技术栈、版本等
API 标准规范：定义统一的接口设计标准，确保 API 一致性
开发标准制定：代码风格、命名规范、架构标准等统一管理
数据库规范：表结构、命名约定、索引策略等标准化

✨ 主要功能

✅ 项目信息管理 - 统一管理项目基本信息和配置
✅ 项目结构分析 - 智能分析项目目录结构和依赖关系
✅ API 接口标准 - 定义统一的 API 设计规范和最佳实践
✅ 开发标准制定 - 代码风格、命名规范、架构标准管理
✅ 数据库规范 - 表结构设计、命名约定、索引策略标准化
✅ API 调试工具 - 完整的 API 接口测试和调试功能
✅ 配置管理 - 基于 JSON 文件的配置存储和管理
✅ 自动重启 - 智能的进程管理和故障恢复
✅ 健康检查 - 实时监控服务状态和性能
✅ 文件下载 - 支持从 URL 直接下载文件到项目目录
✅ 目录列表 - 列出项目目录结构
✅ 规则生成 - 自动生成 .cursorrules 和开发规范文件

🎯 应用场景

团队协作开发

多开发者环境：确保每个开发者的 AI 助手都遵循相同的项目标准
代码审查：统一的代码风格和规范，减少审查时间
新人培训：快速让新团队成员了解项目规范和最佳实践

企业级项目

大型项目：管理复杂的项目结构和多模块开发
微服务架构：统一各个服务的 API 设计和数据库规范
多环境部署：开发、测试、生产环境的标准一致性

AI 辅助开发

智能代码生成：AI 根据项目标准生成符合规范的代码
自动重构：基于标准自动优化和重构代码
规范检查：实时检查代码是否符合项目标准

📦 安装部署

全局安装（推荐）

npm install -g @liangshanli/mcp-server-project-standards

本地安装

npm install @liangshanli/mcp-server-project-standards

源码安装

git clone https://github.com/liliangshan/mcp-server-project-standards.git
cd mcp-server-project-standards
npm install

⚙️ 配置管理

服务器默认使用 ./.setting/ 目录存储配置文件，您可以通过环境变量指定不同的目录。

环境变量

变量名	默认值	描述
`PROJECT_PATH`	.	项目根路径。支持绝对路径和相对路径，用于解析所有相对路径。
`CONFIG_DIR`	./.setting	配置目录，相对于 PROJECT_PATH 解析。
`TOOL_PREFIX`	-	工具名前缀，同时用于多项目配置隔离
`PROJECT_NAME`	-	工具描述前添加项目名称用于标识
`API_DEBUG_ALLOWED_METHODS`	GET	控制允许的请求方法（支持：GET,POST,PUT,DELETE,PATCH等）
`API_DEBUG_LOGIN_URL`	/api/login	设置登录接口 URL
`API_DEBUG_LOGIN_METHOD`	POST	设置登录请求方法
`API_DEBUG_LOGIN_BODY`	{"username":"","password":""}	设置登录请求体
`API_DEBUG_LOGIN_DESCRIPTION`	将返回的token保存到调试工具中的公共header	设置登录接口说明

配置文件

服务器使用两个配置文件：

config.json - 项目标准配置
api.json - API 调试配置

config.json 默认值：

{
  "project_info": {},
  "project_structure": [],
  "api_standards": {},
  "development_standards": [],
  "database_standards": []
}

api.json 默认值：

{
  "baseUrl": "",
  "headers": {
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  "list": []
}

🚀 快速开始

1. 直接运行（全局安装）

mcp-server-project-standards

2. 使用 npx（推荐）

npx @liangshanli/mcp-server-project-standards

3. 源码启动

npm start

4. 托管启动（生产环境推荐）

npm run start-managed

托管启动提供：自动重启（最多10次）、错误恢复、进程管理、日志记录

5. 开发模式

npm run dev

🔧 编辑器配置示例

Cursor 编辑器配置 - 单项目

{
  "mcpServers": {
    "project-standards": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "CONFIG_DIR": "./.setting",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE",
        "API_DEBUG_LOGIN_URL": "/api/login",
        "API_DEBUG_LOGIN_METHOD": "POST",
        "API_DEBUG_LOGIN_BODY": "{\"username\":\"\",\"password\":\"\"}",
        "API_DEBUG_LOGIN_DESCRIPTION": "将返回的token保存到调试工具中的公共header"
      }
    }
  }
}

Cursor 编辑器配置 - 多项目

{
  "mcpServers": {
    "project-standards-A": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "TOOL_PREFIX": "projA",
        "PROJECT_NAME": "项目A",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE"
      }
    },
    "project-standards-B": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "TOOL_PREFIX": "projB",
        "PROJECT_NAME": "项目B",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE"
      }
    }
  }
}

VS Code 配置 - .vscode/mcp.json 格式

单实例配置

{
  "servers": {
    "project-standards": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "CONFIG_DIR": "./.setting",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE",
        "API_DEBUG_LOGIN_URL": "/api/login"
      }
    }
  }
}

多实例配置

{
  "servers": {
    "project-standards-A": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "TOOL_PREFIX": "projA",
        "PROJECT_NAME": "项目A",
        "CONFIG_DIR": "./.setting-a",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE"
      }
    },
    "project-standards-B": {
      "command": "npx",
      "args": ["@liangshanli/mcp-server-project-standards"],
      "env": {
        "PROJECT_PATH": ".",
        "TOOL_PREFIX": "projB",
        "PROJECT_NAME": "项目B",
        "CONFIG_DIR": "./.setting-b",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE"
      }
    }
  }
}

🛠️ 可用工具

1. 项目信息管理 (project_info)

获取和管理项目基本信息，包括项目名称、开发语言、描述等。

{
  "name": "project_info",
  "arguments": {
    "action": "set",
    "key": "projectName",
    "value": "我的项目"
  }
}

2. 项目结构管理 (project_structure)

获取和管理项目目录结构，支持深度控制和隐藏文件包含。

{
  "name": "project_structure",
  "arguments": {
    "action": "set",
    "structure": [{"path": "/src", "description": "源代码目录"}]
  }
}

3. API 标准管理 (api_standards)

获取和管理 API 接口标准和最佳实践。

{
  "name": "api_standards",
  "arguments": {
    "action": "set",
    "key": "requirements",
    "value": ["统一响应格式", "错误码标准"],
    "forceOverwrite": true
  }
}

4. 开发标准管理 (development_standards)

获取和管理开发标准，包括代码风格、Git 工作流、测试和文档规范。

{
  "name": "development_standards",
  "arguments": {
    "action": "set",
    "standards": ["使用2个空格缩进", "使用单引号"],
    "forceOverwrite": false
  }
}

5. 数据库标准管理 (database_standards)

获取和管理数据库规范，包括表结构设计、命名约定、索引策略等。

{
  "name": "database_standards",
  "arguments": {
    "action": "set",
    "standards": ["使用 snake_case 命名表和字段"],
    "forceOverwrite": true
  }
}

6. API 调试工具 (api_debug)

完整的 API 接口测试和调试功能，支持多种 HTTP 方法、认证、参数传递等。

功能特点：

智能 Content-Type 检测：自动判断请求体类型（JSON、XML、HTML、URL编码等）
认证管理：支持 Bearer Token 等认证方式
URL 去重：相同 URL 只保存一份数据，避免重复
执行记录：无论成功失败都记录执行历史
搜索功能：支持按 URL 或描述搜索 API
请求方法限制：默认只允许 GET 请求，防止误操作
登录接口智能识别：自动识别登录接口并使用环境变量配置

7. 目录列表工具 (list_directory)

{
  "name": "list_directory",
  "arguments": {
    "depth": 3
  }
}

8. 规则生成工具 (generate_cursorrules / generate_rules)

根据您的标准生成 AI 项目指导文件（Cursor 使用 .cursorrules，其他客户端使用 PROJECT_RULES.md）。

{
  "name": "generate_cursorrules",
  "arguments": {
    "save": true
  }
}

9. 文件下载工具 (download_file)

从指定的 URL 下载文件并保存到项目路径中的指定位置。

{
  "name": "download_file",
  "arguments": {
    "url": "https://example.com/logo.png",
    "savePath": "assets/logo.png"
  }
}

🔗 相关工具协同使用

🗄️ 数据库管理工具

MySQL 数据库支持 - DDL 操作、权限控制、操作日志、连接池管理
SQL Server 数据库支持 - SQL Server 数据库操作、DDL 支持
MCP Gitee Pull Request - Gitee Pull Request 创建和自动化工作流

🎨 图标管理工具

图标资源管理 - 图标资源管理、图标搜索、图标库集成

🔧 版本控制工具

Git 操作管理 - Git push 操作、待处理修改审查、推送历史跟踪

🌐 浏览器工具

无头浏览器文档抓取 - 基于 Playwright 的无头浏览器，用于渲染和抓取现代 Web 文档

🗃️ 缓存数据库工具

Redis 数据操作 - Redis 数据操作、键管理、权限控制和操作日志

📋 版本历史

v5.1.0 (2025-12-22)

✅ 新增 download_file 工具，支持从 URL 下载文件到项目目录
✅ 服务器和包版本更新至 5.1.0

v5.0.0 (2025-12-19) - 重大更新

✅ 新增 PROJECT_PATH 环境变量，支持相对于项目根目录解析路径
✅ Cursor 自动识别，开启环境特有的增强模式
✅ 新增 list_directory、generate_cursorrules 及 generate_rules 工具
✅ AI 行为准则：在规则生成模板中集成了完善的 AI 行为准则与强制执行逻辑
✅ 安全性增强：为目录扫描工具增加了路径越界校验

v3.0.0 (2025-10-31) - 重大更新

✅ 配置目录解析新增 TOOL_PREFIX 参与多项目隔离
✅ 工具名自动加前缀，调用时自动去除前缀并精准路由
✅ 多项目隔离更简单：仅改环境变量即可切换项目上下文

v1.1.0 (2024-12-19)

✅ API 调试工具环境变量支持
✅ 登录接口智能识别
✅ 请求方法限制，默认只允许 GET 请求

📁 项目结构

mcp-server-project-standards/
├── src/
│   ├── server-final.js           # 主服务器文件
│   └── utils/                    # 工具函数目录
│       ├── get_project_info.js   # 项目信息管理
│       ├── get_project_structure.js # 项目结构管理
│       ├── get_api_standards.js  # API 标准管理
│       ├── get_development_standards.js # 开发标准管理
│       ├── database_standards.js # 数据库标准管理
│       └── api_debug.js          # API 调试工具
├── bin/
│   └── cli.js                    # CLI 启动脚本
├── start-server.js               # 托管启动脚本
├── package.json
└── README.md

查看 GitHub 仓库