Coding Standards MCP

🚀 CORBAT MCP

AI编码标准服务器，让AI生成的代码一次通过代码审查。

🚀 快速开始

⚡ 30秒即可体验 — 只需添加以下配置并开始编码。

1. 添加到您的MCP配置中

{
  "mcpServers": {
    "corbat": {
      "command": "npx",
      "args": ["-y", "@corbat-tech/coding-standards-mcp"]
    }
  }
}

2. 配置文件位置

完整设置指南 适用于所有25+种工具

3. 完成！ Corbat会自动检测您的技术栈并应用合适的标准。

零开销：Corbat在本地运行，检测您的技术栈大约需要50ms。之后，它只是为AI提供上下文。

完全可定制：如果您不喜欢某个规则，可以在 .corbat.json 中覆盖它。跳转至自定义 →

✨ 主要特性

• 解决AI代码审查难题：AI生成的代码通常难以通过代码审查，Corbat MCP通过在AI生成代码之前注入团队的编码标准来解决这个问题。
• 多工具兼容：与GitHub Copilot、Continue、Cline、Tabnine、Amazon Q等25+种工具兼容。
• 自动检测技术栈：Corbat可以自动检测您的技术栈并应用合适的标准。
• 可定制性强：支持交互式设置、手动配置和使用模板进行定制。

💻 使用示例

基础用法

您："创建一个用户注册服务"

没有使用Corbat时，您会得到：

class UserService {
  private users: Map<string, User> = new Map();

  register(name: string, email: string, password: string) {
    if (!name || !email || !password) throw new Error('Invalid input');
    const user = { id: crypto.randomUUID(), name, email, password };
    this.users.set(user.id, user);
    return user;
  }
}
// ✗ 硬编码存储  ✗ 明文密码  ✗ 通用错误  ✗ 无测试

使用Corbat时，您会得到：

// 领域层
interface UserRepository {
  save(user: User): Promise<void>;
  findByEmail(email: string): Promise<User | null>;
}

class EmailAlreadyExistsError extends Error {
  constructor(email: string) {
    super(`Email already registered: ${email}`);
  }
}

// 应用层
class RegisterUserUseCase {
  constructor(
    private readonly repository: UserRepository,
    private readonly hasher: PasswordHasher
  ) {}

  async execute(input: RegisterUserInput): Promise<User> {
    const existing = await this.repository.findByEmail(input.email);
    if (existing) throw new EmailAlreadyExistsError(input.email);

    const user = User.create({
      ...input,
      password: await this.hasher.hash(input.password)
    });
    await this.repository.save(user);
    return user;
  }
}
// ✓ 存储库接口  ✓ 密码哈希  ✓ 自定义错误  ✓ 可测试

// 包含测试
describe('RegisterUserUseCase', () => {
  const repository = { save: vi.fn(), findByEmail: vi.fn() };
  const hasher = { hash: vi.fn() };
  const useCase = new RegisterUserUseCase(repository, hasher);

  beforeEach(() => vi.clearAllMocks());

  it('should hash password before saving', async () => {
    repository.findByEmail.mockResolvedValue(null);
    hasher.hash.mockResolvedValue('hashed_password');

    await useCase.execute({ name: 'John', email: 'john@test.com', password: 'secret' });

    expect(hasher.hash).toHaveBeenCalledWith('secret');
    expect(repository.save).toHaveBeenCalledWith(
      expect.objectContaining({ password: 'hashed_password' })
    );
  });

  it('should reject duplicate emails', async () => {
    repository.findByEmail.mockResolvedValue({ id: '1', email: 'john@test.com' });

    await expect(
      useCase.execute({ name: 'John', email: 'john@test.com', password: 'secret' })
    ).rejects.toThrow(EmailAlreadyExistsError);
  });
});

这就是“一次通过代码审查”的样子。

📚 详细文档

Corbat强制执行的标准

Corbat在代码生成之前注入以下规则：

代码质量

架构

错误处理

安全（根据OWASP Top 10验证）

基准测试结果v3.0

我们在6种语言的15个实际场景中对Corbat进行了评估。

关键洞察

Corbat生成聚焦、可用于生产的代码 — 而非冗长的样板代码：

这并非“为了减少代码而减少代码” — 而是采用了正确的抽象，避免过度设计。

价值指标

当我们衡量生产代码真正重要的指标时：

📊 详细价值分析

安全：未检测到漏洞

每个场景都使用模式检测对OWASP Top 10漏洞进行了分析：

• ✓ 无SQL/NoSQL注入模式
• ✓ 无XSS漏洞
• ✓ 无硬编码凭证
• ✓ 在所有边界进行输入验证
• ✓ 正确的错误消息（不向用户显示堆栈跟踪）

测试的语言和模式

📖 完整基准测试方法 · 价值分析

内置配置文件

Corbat会自动检测您的技术栈并应用合适的标准：

自动检测：Corbat会读取 pom.xml、package.json、go.mod、Cargo.toml 等文件。

使用场景

何时可能不需要Corbat

• 对质量要求不高的快速原型
• 一次性脚本，用完即弃
• 用于学习的项目，您希望犯错误

🔧 技术细节

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ 您的提示   │────▶│ Corbat MCP  │────▶│ AI + 规则  │
└─────────────┘     └──────┬──────┘     └─────────────┘
                          │
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
    ┌────────────┐ ┌────────────┐ ┌────────────┐
    │ 1. 检测    │ │ 2. 加载    │ │ 3. 注入    │
    │   技术栈   │ │  配置文件  │ │  规则      │
    └────────────┘ └────────────┘ └────────────┘
     pom.xml        六边形架构      每个方法最多20行
     package.json   + DDD          + 接口
     go.mod         + SOLID        + 自定义错误

Corbat不会修改AI的输出 — 它确保AI在生成代码之前了解您的标准。

重要提示：Corbat为AI提供上下文和指导方针。实际的代码质量取决于AI模型遵循这些指导方针的程度。在我们的测试中，Claude和GPT - 4等模型始终遵循这些规则。

📄 许可证

本项目采用 MIT许可证。

文档资源

{ "mcpServers": { "corbat": { "command": "npx", "args": ["-y", "@corbat-tech/coding-standards-mcp"] }}}