@m00nsolutions/mcp-server

MCPによるエージェント型テスト管理。このサーバーを使うと、AIアシスタントは説明を読むだけでなく実際に作業を行えます。テストケースの作成、手動テスト実行の計画と記録、対象とするテストケースへの自動化の関連付け、リリースの公開、そしてM00N Report（AIネイティブなテスト管理プラットフォーム）でのプロジェクト健全性の確認が可能です。

どのインストールが必要ですか？

claude.ai または claude.com から接続しない場合は、MCPキーを付けてこのパッケージを使用してください。これがこのREADMEの残りの内容です。詳細については、コネクタガイド を参照してください。

Related MCP server: @testneo/mcp-server

必要条件

Node 20 以降、およびMCP対応のクライアントが必要です。

インストール

インストール手順はありません。クライアントは、後述の設定に従ってnpxで起動します。

共有環境やCI環境でバージョンを固定するには、argsのパッケージ名にバージョンを追加してください。例: ["-y", "@m00nsolutions/mcp-server@<version>"]。npm view @m00nsolutions/mcp-server versions で公開されているバージョンを一覧できます。実際の数字ではなくプレースホルダーにしているのは意図的なものです。具体的な例は次のリリースで古くなるため、古い例では現在の修正が含まれていないバージョンを固定してしまうからです。

クイックスタート

1. MCPキーの取得

M00N Reportで 設定 -> MCPキー を開き、キーを作成します。キーは m00n_mcp_ で始まり、その後に48文字の16進文字が続きます。これはテストレポーターが使用する認証情報とは異なります。テストレポーターの認証情報は m00n_ で始まり、ここでは拒否されます。

MCPキーは、そのキーが所属するアカウントと正確に同じ権限を持ちます。それ以上の権限はありません。さらにスコープを狭めることもできます。スコープを狭めるとクライアントに表示されるツール一覧からツールが削除されるため、表示されるツールが予想より少ない場合はスコープの設定によるものであり、不具合ではありません。

キーは、自分のマシンのMCPクライアント設定に保存します。リポジトリ内にあるワークスペースファイルには保存しないでください。

2. クライアントの接続

Claude Code の場合、1行で済みます:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

他のすべてのクライアントでは、同じJSONブロックを使用します:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

そのブロックの保存場所:

セルフホストインスタンスの場合は、M00N_API_URL を /api 接頭辞を付けずに、自分のルートオリジンに向けてください。末尾のスラッシュは自動的に除去されます。

3. 接続の確認

クライアントを再起動し、次のように依頼してください:

私のM00N Reportプロジェクトを一覧表示して

プロジェクト一覧が表示されれば、サーバーに接続され、キーが有効であることを示します。エラーが返される場合、またはアシスタントがそのようなツールを持っていないと言う場合は、接続されていないことを示します。トラブルシューティング を参照してください。

ツール

8つの領域があります。引数を含む完全な一覧は /documentation/mcp/tools にあり、コードと一緒に管理されています。サーバーは起動時に自身のインスタンスからツール一覧を取得するため、クライアントに表示されるのは、接続した時点でインスタンスがサポートしていた内容です。

実行とは、手動のテスト実行です。担当者、環境、日付、また、ケースが追加された時点のスナップショットに対して記録されるステップごとの結果で構成されます。

キーが表示できるツールの数は、あなたのインスタンスによって決まります:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

これは、m00nreport.com でスコープを限定していないキーを使用し、2026-08-22 に確認したところ、57件を返しました。

プロンプト

名前によってクライアントが提供できる、段階的なワークフローです。それぞれがオプションの project 引数（名前またはUUID）を1つ受け取ります。省略した場合、サーバーは圏内にプロジェクトが1つしかない場合にそのプロジェクトを選択します。

リソース

ツールを呼び出さなくてもクライアントが取得できる読み取り専用ビュー: 全プロジェクト、プロジェクト健全性サマリー、不安定なテストのレポート、現在失敗しているテスト、フォルダー構造、テスト実行レポート、テストケースの内容、リリースサマリー。

設定

2つのブール値は、true、1、yes のいずれか、または大文字小文字を限られずです。それ以外の値（false や 0 を含む）ではオフになります。

最初の2つは、両方を設定するかどちらも設定しないでください。片方だけ設定するとエ扱いとされ拒否されます。途中まで設定されたサーバーが起動してしまうよりも、破損しないほうが原因を特定しやすいからです。

ここでのベースURLは M00N_API_URL です。テストレポーターは同じURLを M00N_SERVER_URL と呼びます。6つすべてのパッケージが M00N_API_KEY を読み取りますが、それらはMCPキーではなくプロジェクトAPIキーであるため、1つのエクスポートされたシェル変数で両方に利用することはできません。

キーなしの実行

M00N_API_URL と M00N_API_KEY をどちらも設定せずに起動すると、サーバはプレビューモードで実行されます。バンドルされたスナップショットからツール、プロンプト、リソースを一覧表示し、何を設定すべきかを示すメッセージを添えてすべての呼び出しを拒否します。送信先がないため、何も送信されません。

これにより、インスペクタ、クライアント、ディレクトリは、サインアップする前にツールの内容を表示できます。これはサーバの説明であり、実際に動作するものではありません。したがって、一覧はあなたのインスタンスからではなく、スナップショットから取得されます。スコープを制限されたキーは、通常スナップショットに表示される数より少ないツールしか表示しないことがあります。

メンテナーは、スコープを設定していないキーを使って npm run snapshot:refresh を実行し、スナップショットを更新します。

セルフホスト

M00N_API_URL を自分のインスタンスに向けて、そのインスタンスからMCPキーを発行します。それ以外はすべて同じです。テストデータを自分のネットワーク外に出せないという理由でセルフホストを使用している場合は、この点が重要です。

自己署名証明書を使用する場合は、同じ env ブロックに "M00N_INSECURE_SSL": "true" と追加します。詳細な情報は、/documentation/mcp/self-hosted を参照してください。

送信される内容

HTTPSで M00N_API_URL に送信されるのは、アシスタントが行うツール呼び出しと、その引数だけ。サーバーはあなたのインスタンスへのプロキシであり、自らは何も保存しません。

すべてのツール呼び出しは、アプリ内にUIを持つMCP監査ログに記録され、キーごとのレート制限により暴走エージェントを制限します。キーがそのログやstderrに書き込まれることはありません。M00N_DEBUG が有効な場合、各ツールから呼び出しの中の引数まで stderr に出力されるため、その出力はデータ自体と同じように扱ってください。

トラブルシューティング

サーバーは M00N_DEBUG の有無にかかわらず stderr にログを出力し、ほとんどのクライアントはそれを MCP パネルに表示します。M00N_DEBUG を true に設定すると、各リクエストとその引数も出力されます。

既知の制限

• ツール一覧は起動時に一度だけ読み込まれます。 キーのスコープを変更するか、インスタンスをアップグレードしても、クライアントを再起動するまで古い一覧が使われます。

• GET /api/health は設定されている場合、到達可能でなければなりません。 これは最初に確認され、失敗するとサーバーが停止します。そのため、/api/mcp/* のみを転送するプロキシでは、すべてのツールが機能してもツールが一切表示されません。

• 工具がゼロにスコープされたキーでは起動しません。 サーバーは空の一覧で接続するのではなく終了します。これは設定上の動作です。認証情報がまったくない場合は、代わりにプレビューモードで起動します。

• プロンプトとリソースは任意です。 それらの一覧取得が失敗してもサーバーは起動し、理由が stderr に出力され、クライアントはセッション中それらを一切表示しません。

• リダイレクトは拒否され、追跡されません。 キーはカスタムヘッダーに含まれます。リダイレクト フォロワーは認識している認証ヘッダーのみを除去するため、追跡するとキーが 次に応答したホストへ渡ってしまいます。リダイレクトは、その先のアドレスとともに報告されます。

• stdio のみ。 HTTP トランスポートには、ホスト型コネクタを使用してください。

サポート

• npm のパッケージ

• ドキュメント

• 問題を報告

• コミュニティ Discord

ライセンス

MIT License。LICENSE をご覧ください。