Mercury Spec Ops

🚀 マーキュリー・スペック・オペレーションズMCPサーバー：プロンプトとリソースを**ツール**として

プロンプト生成とテンプレート組み立てのために動的なAI呼び出し可能なツールを公開する最初のMCPサーバーです。

AIアシスタントが専門コンテンツとやり取りする方法を変革します。静的なプロンプトとリソースではなく、マーキュリー・スペック・オペレーションズは6つのプログラム可能なツールを提供し、AIが技術固有のプロンプトと包括的なテンプレートをオンデマンドで動的に生成できるようにします。31の技術スタック、10の分析次元、34のテンプレートセクションを備えた高度なモジュールアーキテクチャに基づいて構築されており、すべてが簡単なツール呼び出しでアクセス可能です。

✨ 主な機能

このMCPサーバーは、次のようなモジュール式で拡張可能なアーキテクチャを提供します。

プロンプト（列挙型サポートで強化）

1. PRDプロンプト - モジュール式の技術固有の分析を用いて製品要件文書を生成します。
2. コードベース分析プロンプト - モジュール式の技術/焦点固有の分析を用いてコードベースを分析します。
3. バグ分析プロンプト - モジュール式の重大度/技術固有の分析を用いてバグを分析します。

リソース（モジュール式テンプレート）

1. PRDテンプレート - 技術固有のセクションを持つモジュール式PRDテンプレートです。
2. コードベース分析テンプレート - 技術/焦点固有のセクションを持つモジュール式コードベース分析テンプレートです。
3. バグ分析テンプレート - 重大度/技術固有のセクションを持つモジュール式バグ分析テンプレートです。

主要な機能

列挙型ベースの入力検証

• 技術スタック（合計31）：
  • 言語（11）：JavaScript、TypeScript、Python、Java、Go、Rust、C#、PHP、Ruby、Swift、Kotlin
  • ランタイム（1）：Node.js
  • フロントエンド（3）：React、Angular、Vue
  • バックエンド（7）：Express、NestJS、Django、Flask、Spring、Laravel、Rails
  • データベース（4）：MongoDB、PostgreSQL、MySQL、Redis
  • クラウド（3）：AWS、Azure、GCP
  • DevOps（2）：Docker、Kubernetes
• 分析焦点（合計10）：アーキテクチャ、セキュリティ、パフォーマンス、テスト、ドキュメント、保守性、拡張性、信頼性、コード品質、依存関係
• バグの重大度（合計4）：低、中、高、重大
• 対象ユーザー：開発者、ビジネスユーザー、エンタープライズ、スタートアップ、医療、金融など

プログラムによるプロンプト組み立て

• 基本プロンプト + 31の技術モジュール + 10の焦点モジュール + 4の重大度モジュール
• 入力パラメータに基づく自動モジュール選択
• 優先度ベースのモジュール順序付け
• 複数値サポート：複数の技術と焦点領域を同時に分析できます。
• カンマ区切りの入力："node.js,react,postgresql" または "security,performance,code-quality"
• カスタム命令の統合
• 基本プロンプトへのインテリジェントフォールバック

モジュール式テンプレートシステム

• 依存関係解決を持つテンプレートセクション
• 技術固有のテンプレートセクション
• 焦点固有のテンプレートセクション
• カスタムセクションサポート

📦 インストール

オプション1: ローカル開発

1. リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/n0zer0d4y/mercury-spec-ops.git
cd mercury-spec-ops
npm install
npm run build

2. サーバーをローカルで実行します。

npm run mcp

オプション2: npmからインストール

npm install -g @n0zer0d4y/mercury-spec-ops

または、npx を直接使用して（インストール不要）：

npx @n0zer0d4y/mercury-spec-ops

💻 使用例

MCPクライアントとの統合

MCPクライアント（Claude Desktop、Cursorなど）でサーバーを設定します。

npxを使用する場合（推奨 - インストール不要）

Claude Desktopの場合 (claude_desktop_config.json)：

{
  "mcpServers": {
    "mercury-spec-ops": {
      "command": "npx",
      "args": ["-y", "@n0zer0d4y/mercury-spec-ops"]
    }
  }
}

Cursorの場合 (~/.cursor/mcp.json)：

{
  "mcpServers": {
    "mercury-spec-ops": {
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@n0zer0d4y/mercury-spec-ops"]
    }
  }
}

ローカルインストールを使用する場合

Claude Desktopの場合 (claude_desktop_config.json)：

{
  "mcpServers": {
    "mercury-spec-ops": {
      "command": "node",
      "args": ["/path/to/mercury-spec-ops/dist/src/server.js"]
    }
  }
}

Cursorの場合 (~/.cursor/mcp.json)：

{
  "mcpServers": {
    "mercury-spec-ops": {
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mercury-spec-ops/dist/src/server.js"]
    }
  }
}

Windowsのローカルパスの例（Cursor）：

{
  "mcpServers": {
    "mercury-spec-ops": {
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "C:\\Development\\Projects\\MCP-Servers\\mercury-spec-ops\\dist\\src\\server.js"
      ]
    }
  }
}

重要な注意事項:

• npx：npmから最新バージョンを自動的に取得します（ほとんどのユーザーに推奨）
• ローカル：パスを実際のプロジェクトの場所に置き換え、最初に npm run build を実行してください。
• 再起動：設定を変更した後は、MCPクライアントを再起動してください。

ワークフローの例

例1: 強化されたコードベース分析

1. ユーザープロンプト："このNode.js/TypeScriptのコードベースをセキュリティとパフォーマンスに焦点を当てて分析してください"
2. Claude Desktopのアクション：
   • codebase-analysis-prompt をtechnology_stack: "node.js,typescript" と analysis_focus: "security,performance" で呼び出します。
   • システムがプログラム的に組み立てます：基本プロンプト + Node.jsモジュール + TypeScriptモジュール + セキュリティモジュール + パフォーマンスモジュール
   • プロンプトがClaudeに resource://codebase-analysis-template を最初に読み取るように指示します。
   • テンプレートビルダーが組み立てます：基本テンプレート + Node.jsセクション + TypeScriptセクション + セキュリティセクション + パフォーマンスセクション
   • Claudeが動的に組み立てられたテンプレートを読み取ります。
   • Claudeがコードベースを分析し、包括的な技術固有のレポートを生成します。

例2: 強化されたバグ分析

1. ユーザープロンプト："このReactアプリケーションの重大なセキュリティバグを分析してください"
2. Claude Desktopのアクション：
   • bug-analysis-prompt をtechnology_stack: "react"、severity_level: "critical"、およびbug_type: "security" で呼び出します。
   • システムが組み立てます：基本プロンプト + Reactモジュール + セキュリティモジュール + 重大度モジュール
   • テンプレートには：一般セクション + React固有 + セキュリティ固有 + 重大度固有のセクションが含まれます。
   • Claudeがバグ分析テンプレートを読み取ります。
   • Claudeがバグを分析し、包括的な技術と重大度固有のレポートを生成します。

例3: 技術サポート付きのPRD生成

1. ユーザープロンプト："Reactベースのタスク管理アプリケーションのPRDを作成してください"
2. Claude Desktopのアクション：
   • prd-prompt をプロジェクト詳細とtechnology_stack: "react" で呼び出します。
   • システムが組み立てます：基本プロンプト + Reactモジュール
   • テンプレートビルダーには：基本PRDテンプレート + React固有の考慮事項が含まれます。
   • Claudeが技術強化されたPRDテンプレートを読み取ります。
   • ClaudeがReact固有のセクションを含む包括的なPRDを生成します。

プロンプトの詳細

PRDプロンプト

• 名前：prd-prompt
• 引数：
  • project_name（必須）：ソフトウェアプロジェクトの名前
  • project_description（必須）：プロジェクトの簡単な説明
  • target_audience（オプション）：製品の対象ユーザー（列挙型値）
  • project_type（オプション）：プロジェクトのタイプ（列挙型値）
  • key_features（オプション）：PRDに含める主要な機能
  • technology_stack（オプション）：使用する技術スタック（列挙型値）
  • custom_instructions（オプション）：PRD生成のためのカスタム命令

コードベース分析プロンプト

• 名前：codebase-analysis-prompt
• 引数：
  • repository_path（必須）：分析するリポジトリのパス
  • technology_stack（必須）：コードベースで使用される技術スタック（列挙型値）
  • analysis_focus（オプション）：分析の焦点領域（列挙型値）
  • custom_instructions（オプション）：コードベース分析のためのカスタム命令

バグ分析プロンプト

• 名前：bug-analysis-prompt
• 引数：
  • repository_path（必須）：バグを分析するリポジトリのパス
  • bug_description（必須）：分析するバグまたは問題の説明
  • affected_components（オプション）：バグの影響を受けるコンポーネント
  • severity_level（オプション）：バグの重大度レベル（列挙型値）
  • bug_type（オプション）：バグのタイプ（列挙型値）
  • technology_stack（オプション）：影響を受けるコンポーネントで使用される技術スタック（列挙型値）
  • custom_instructions（オプション）：バグ分析のためのカスタム命令

リソースの詳細

PRDテンプレート

• URI：resource://prd-template
• 形式：Markdown
• 内容：入力パラメータに基づいて動的に組み立てられる技術固有のセクションを持つモジュール式PRDテンプレートです。

コードベース分析テンプレート

• URI：resource://codebase-analysis-template
• 形式：Markdown
• 内容：分析パラメータに基づいて組み立てられる技術と焦点固有のセクションを持つモジュール式コードベース分析テンプレートです。

バグ分析テンプレート

• URI：resource://bug-analysis-template
• 形式：Markdown
• 内容：バグパラメータに基づいて組み立てられる重大度と技術固有のセクションを持つモジュール式バグ分析テンプレートです。

開発

プロジェクト構造

src/
├── server.ts                    # メインのMCPサーバー実装
├── types/
│   ├── enums.ts                 # すべての列挙型定義（31の技術 + 10の焦点）
│   └── index.ts                 # 型定義とエクスポート
├── prompts/
│   ├── modules/                 # 45のモジュール式プロンプトコンポーネント
│   │   ├── technology/          # 31の技術固有のモジュール
│   │   │   ├── languages/       # 11の言語モジュール
│   │   │   ├── runtimes/        # 1のランタイムモジュール
│   │   │   ├── frameworks/      # 10のフレームワークモジュール（3つのフロントエンド、7つのバックエンド）
│   │   │   ├── databases/       # 4のデータベースモジュール
│   │   │   ├── cloud/           # 3のクラウドプラットフォームモジュール
│   │   │   └── tools/           # 2のDevOpsツールモジュール
│   │   ├── analysis-focus/      # 10の焦点領域モジュール
│   │   └── bug-severity/        # 4の重大度固有のモジュール
│   ├── base-prompts/            # 基本プロンプトテンプレート
│   └── prompt-builder.ts        # プログラムによるプロンプト組み立て
├── resources/
│   ├── templates/               # モジュール式テンプレートコンポーネント
│   │   ├── prd/                 # 10のPRDテンプレートモジュール
│   │   ├── codebase-analysis/   # 8のコードベース分析モジュール
│   │   └── bug-analysis/        # 4のバグ分析モジュール
│   └── template-builder.ts      # プログラムによるテンプレート組み立て
└── __tests__/                   # 包括的なテストスイート（66のテスト）
    ├── utils/                   # ユーティリティ関数のテスト（列挙型パーサー）
    ├── prompts/                 # プロンプトビルダーのテスト
    ├── resources/               # テンプレートビルダーのテスト
    └── types/                   # 列挙型と型のテスト

テスト

このプロジェクトには、88%のカバレッジを持つ包括的なテストスイートが含まれています。

# すべてのテストを実行
npm test

# ウォッチモードでテストを実行
npm run test:watch

# カバレッジレポート付きでテストを実行
npm run test:coverage

# インタラクティブUIでテストを実行
npm run test:ui

# MCP統合をテスト
npm run test:mcp

システムの拡張

新しい技術モジュールの追加

1. src/types/enums.ts の TechnologyStack 列挙型に技術を追加します。
2. 適切なカテゴリに新しいモジュールファイルを作成します。
   • 言語：src/prompts/modules/technology/languages/
   • フレームワーク：src/prompts/modules/technology/frameworks/frontend/ または backend/
   • データベース：src/prompts/modules/technology/databases/
   • クラウド：src/prompts/modules/technology/cloud/
   • ツール：src/prompts/modules/technology/tools/
3. TechnologyPromptModule インターフェースを実装します。
4. カテゴリの index.ts からエクスポートします。
5. prompt-builder.ts で登録します。
6. src/resources/templates/ に対応するテンプレートセクションを追加します。
7. src/__tests__/ にテストを書きます。

新しい焦点領域の追加

1. src/types/enums.ts の AnalysisFocus 列挙型に焦点領域を追加します。
2. src/prompts/modules/analysis-focus/ に新しいモジュールファイルを作成します。
3. AnalysisFocusPromptModule インターフェースを実装します。
4. analysis-focus/index.ts からエクスポートします。
5. prompt-builder.ts で登録します。
6. 対応するテンプレートセクションを追加します。
7. テストを書きます。

新しい重大度レベルの追加

1. src/types/enums.ts の BugSeverity 列挙型に重大度を追加します。
2. src/prompts/modules/bug-severity/ に新しいモジュールファイルを作成します。
3. BugSeverityPromptModule インターフェースを実装します。
4. プロンプトビルダーで登録します。
5. 対応するテンプレートセクションを追加します。
6. テストを書きます。

コントリビューション

コントリビューションは大歓迎です！次のガイドラインに従ってください。

• リポジトリをフォークし、機能ブランチを作成します。
• 既存のコードパターンに従い、テストカバレッジを85%以上に維持します。
• Conventional Commits 形式（feat、fix、docs、test、chore）を使用します。
• プルリクエストを送信する前に、すべてのテストが通過することを確認してください。
• 新しいモジュールを追加するには、システムの拡張 を参照してください。

問題は GitHub Issues に明確な再現手順を添えて報告してください。

📄 ライセンス

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