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"] }}}