Coding Standards MCP Server

Coding Standards MCP Server

此 MCP 服务提供用于访问各种技术（Java、Python、React）编码风格指南和最佳实践的工具。

前提条件

• Python 3.8 或更高版本
• MCP 包（pip install mcp）
• UV 包管理器（推荐）

快速开始

1. 在 Claude 中安装此服务：

mcp install server.py

2. 在开发模式下运行：

mcp dev server.py

MCP 检查器将在端口 3000 上启动。

可用工具

风格指南

访问特定语言的编码风格指南：

• Java：整洁代码实践、命名约定、代码组织
• Python：基于 PEP 8 的指南、Pythonic 代码实践
• React：组件结构、Hook 的使用、TypeScript 集成

最佳实践

访问特定语言的应用最佳实践：

• Java：项目结构、架构、测试、安全性
• Python：项目布局、依赖管理、测试实践
• React：组件模式、状态管理、性能优化

API 参考

1. java_style_guide：获取 Java 编码风格指南

   • 返回：Markdown 格式的风格指南
   • 示例：nortal_coding_standards_java_style_guide()

2. java_best_practices：获取 Java 应用最佳实践

   • 返回：Markdown 格式的最佳实践
   • 示例：nortal_coding_standards_java_best_practices()

3. python_style_guide：获取 Python 编码风格指南

   • 返回：Markdown 格式的风格指南
   • 示例：nortal_coding_standards_python_style_guide()

4. python_best_practices：获取 Python 应用最佳实践

   • 返回：Markdown 格式的最佳实践
   • 示例：nortal_coding_standards_python_best_practices()

5. react_best_practices：获取 React 应用最佳实践

   • 返回：Markdown 格式的最佳实践
   • 示例：nortal_coding_standards_react_best_practices()

配置

MCP 客户端配置

将以下内容添加到 MCP 客户端配置文件中（例如，~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "nortal_coding_standards": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/absolute/path/to/coding-standards-mcp/server.py"
      ]
    }
  }
}

将 /absolute/path/to/coding-standards-mcp/server.py 替换为实际的服务路径。

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。