Coding Standards MCP

🚀 CORBAT MCP

AIコーディング標準サーバー

初めてのコードレビューで合格するAI生成コード。

GitHub Copilot、Continue、Cline、Tabnine、Amazon Q、および25以上のツールと互換性があります。

⚡ 30秒で試す — 以下の設定を追加してコーディングを開始しましょう。

🚀 クイックスタート

1. MCP設定に追加

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

2. 設定ファイルの場所

すべての25以上のツールの完全なセットアップガイド

3. 完了！

Corbatは自動的にスタックを検出し、適切な標準を適用します。

オーバーヘッドゼロ。 Corbatはローカルで実行され、スタックを検出するのに約50msかかります。その後は、AIにとってのコンテキストとなります。

完全にカスタマイズ可能。 ルールが気に入らない場合は、.corbat.jsonで上書きできます。カスタマイズにジャンプ →

✨ 主な機能

問題解決

AIによって生成されたコードは動作しますが、コードレビューに合格することはめったにありません。Corbat MCPは、AIがコードを生成する前にチームのコーディング標準を注入することで、この問題を解決します。

実際の動作を確認

あなた: "ユーザー登録サービスを作成して"

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が必要ない場合

• 品質が重要でないクイックプロトタイプ
• 使い捨てのスクリプト
• 間違いを犯したい学習プロジェクト

📚 ドキュメント

🔧 技術詳細

動作原理

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ Your Prompt │────▶│ Corbat MCP  │────▶│ AI + Rules  │
└─────────────┘     └──────┬──────┘     └─────────────┘
                          │
           ┌──────────────┼──────────────┐
           ▼              ▼              ▼
    ┌────────────┐ ┌────────────┐ ┌────────────┐
    │ 1. Detect  │ │ 2. Load    │ │ 3. Inject  │
    │   Stack    │ │  Profile   │ │ Guardrails │
    └────────────┘ └────────────┘ └────────────┘
     pom.xml        hexagonal      max 20 lines
     package.json   + DDD          + interfaces
     go.mod         + SOLID        + custom errors

CorbatはAIの出力を変更するのではなく、AIがコードを生成する前に標準を知るようにします。

重要: CorbatはAIにコンテキストとガイドラインを提供します。実際のコード品質は、AIモデルがこれらのガイドラインに従う程度に依存します。私たちのテストでは、ClaudeやGPT - 4などのモデルは一貫してこれらのガードレールを尊重しています。

📦 インストール

オプション1: インタラクティブなセットアップ

npx corbat-init

スタックを検出し、適切なデフォルト値で .corbat.json を生成します。

オプション2: 手動設定

プロジェクトルートに .corbat.json を作成します。

{
  "profile": "java-spring-backend",
  "architecture": {
    "pattern": "hexagonal",
    "layers": ["domain", "application", "infrastructure", "api"]
  },
  "quality": {
    "maxMethodLines": 20,
    "maxClassLines": 200,
    "minCoverage": 80
  },
  "rules": {
    "always": [
      "Use records for DTOs",
      "Prefer Optional over null"
    ],
    "never": [
      "Use field injection",
      "Catch generic Exception"
    ]
  }
}

オプション3: テンプレートを使用する

14のすぐに使えるテンプレートを参照 Java、Python、Node.js、React、Go、Rustなどのテンプレートがあります。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

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