Heliyos

Heliyos MCP サーバー

収益向けAIオペレーティングシステムHeliyosにAIエージェントを接続します。

@heliyos/heliyos-mcpは、Heliyos向けのModel Context Protocolサーバーです。お使いのマシン上でstdio経由で動作し、ワークスペースAPIキーを使ってHeliyos APIを呼び出すため、Claude Code、Codex、Cursor、VS Code、Antigravity、その他あらゆるMCPクライアント上のエージェントがCRMで作業できます。

ドキュメント：docs.heliyos.ai/mcp · インストールガイド · すべてのツール · API リファレンス · 変更履歴

これを使うと、エージェントは次のことができます。

• 会社、人物、案件、カスタムオブジェクトを検索・更新し、それらにフィールドを追加する
• レコードのタイムライン、変更履歴、メール、ミーティングを読み取る
• メモやタスクを書き込み、タスクに取り組むHeliyosワーカーを起動する
• 人による確認待ちのレビューを一覧表示し、承認または却下する
• トリガーとツールのカタログからワーカーを作成・設定する
• スカウトを管理し、そのシグナルを読み取り、ウォッチリストを維持する
• ナレッジベースを読み取り・編集し、ワーカーが読むファイルをアップロードする
• heliyos_askを使ってHeliyosにジョブを依頼し、実行状況を追跡する

ワーカーが実行する重要なアクションは引き続きHeliyosでのレビュー待ちとなるため、チームは制御を保てます。

クイックスタート

1. Heliyosの設定 → APIキーでAPIキーを作成します（詳細は以下を参照）。

2. サーバーをクライアントに追加します。Claude Codeの場合：

   claude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos -- npx -y @heliyos/heliyos-mcp
   

3. エージェントに「接続しているHeliyosワークスペースはどれですか？」と尋ねます。heliyos_organization_getを呼び出し、ワークスペース名を答えます。

その他すべてのクライアントについては、インストールを参照してください。

目次

• クイックスタート
• 開始前の準備
• インストール
• ツールのタイムアウト
• 設定
• ツール
• セキュリティ
• トラブルシューティング
• 開発
• コントリビューション
• ライセンス

始める前に

Node.js 20 以降（node -v）と Heliyos API キーが必要です。

キーを作成するには：

1. Heliyos を開き、Settings → API keys（gtm.heliyos.ai/settings/api-keys）に移動します。
2. New key をクリックします。「Claude Code on my laptop」のように、見てわかる名前を付け、必要であれば有効期限を設定してから、Create key をクリックします。
3. キーをコピーします。キーは heliyos_ で始まり、一度だけ表示されます。紛失した場合は、キーを取り消して新しいキーを作成してください。

キーを作成できるのは、ワークスペースのオーナーと管理者のみです。キーには、作成したワークスペース１つに対する管理者アクセス権があり、それ以外へのアクセス権はありません。他のキーに影響を与えずに１つのキーを取り消せるように、ユーザーとマシンごとに１つのキーを使用してください。

インストール

どのクライアントでも、HELIYOS_API_KEY 環境変数にキーを設定して、同じコマンド npx -y @heliyos/heliyos-mcp を実行します。以下の例では、YOUR_HELIYOS_API_KEY をご自身のキーに置き換えてください。

Claude Code

プラグインをインストールし、キーを一度に設定します。キーはシステムの安全な認証情報ストアに保存され、ファイルには保存されません。また、プラグインによって、Claude が各ツールをいつ使うべきかを案内するスキルが追加されます。

claude plugin marketplace add heliyos-ai/heliyos-mcp
claude plugin install heliyos@heliyos --config api_key=YOUR_HELIYOS_API_KEY

--config を使わずにインストールした場合、キーを設定するまでサーバーは無効のままです。Claude Code 内で /plugin configure heliyos@heliyos を実行し、キーを入力してください。その後、/mcp に heliyos が表示されます。表示されない場合は、Claude Code を再起動してください。

または、MCP サーバーのみを追加します。

claude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos -- npx -y @heliyos/heliyos-mcp

claude mcp list またはセッション内の /mcp で確認してください。

Claude Desktop

Settings → Developer → Edit Config を開き、claude_desktop_config.json にサーバーを追加してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "heliyos": {
      "command": "npx",
      "args": ["-y", "@heliyos/heliyos-mcp"],
      "env": { "HELIYOS_API_KEY": "YOUR_HELIYOS_API_KEY" }
    }
  }
}

このファイルにはキーが平文で保存されるため、他人に見られないようにしてください。claude.ai のカスタムコネクターおよび Claude コネクターのディレクトリを使うには、OAuth 対応のホスト型（リモート）MCP サーバーが必要です。Heliyos はまだ提供していないため、現時点ではローカルクライアントを使用してください。

Codex

~/.codex/config.toml にサーバーを追加します。

[mcp_servers.heliyos]
command = "npx"
args = ["-y", "@heliyos/heliyos-mcp"]
env_vars = ["HELIYOS_API_KEY"]
startup_timeout_sec = 30
tool_timeout_sec = 120

env_vars は Codex の起動元シェルから HELIYOS_API_KEY を渡すため、シェルで変数をエクスポートしてください（たとえば ~/.zshrc に設定します）。代わりにキーをファイルに保存する場合は、env_vars の行を末尾の env テーブルに置き換えてください。

[mcp_servers.heliyos.env]
HELIYOS_API_KEY = "YOUR_HELIYOS_API_KEY"

CLI でも同じ設定を１行で行えます。その後、CLI が書き込んだテーブルに tool_timeout_sec = 120 を追加してください。

codex mcp add heliyos --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY -- npx -y @heliyos/heliyos-mcp

Cursor

Heliyos を Cursor に追加

このリンクをクリックするとディープリンクが開きます。このリンクをブラウザーに貼り付けることもできます。

cursor://anysphere.cursor-deeplink/mcp/install?name=heliyos&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBoZWxpeW9zL2hlbGl5b3MtbWNwIl0sImVudiI6eyJIRUxJWU9TX0FQSV9LRVkiOiIke2VudjpIRUxJWU9TX0FQSV9LRVl9In19

次のエントリーが ~/.cursor/mcp.json に追加されます。

{
  "mcpServers": {
    "heliyos": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@heliyos/heliyos-mcp"],
      "env": { "HELIYOS_API_KEY": "${env:HELIYOS_API_KEY}" }
    }
  }
}

Cursor は独自の環境から ${env:HELIYOS_API_KEY} を読み取ります。シェルのプロファイルで変数をエクスポートし、そのシェルから Cursor を起動するか、値をご自身のキーに置き換えてください。このリポジトリで npm run install-links を実行すると、リンクを再度表示できます。

VS Code

Heliyos を VS Code にインストール

このリンクをクリックするとディープリンクが開きます。このリンクをブラウザーに貼り付けることもできます。

vscode:mcp/install?%7B%22name%22%3A%22heliyos%22%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22heliyos-api-key%22%2C%22description%22%3A%22Heliyos%20API%20key%20(Settings%20%E2%86%92%20API%20keys)%22%2C%22password%22%3Atrue%7D%5D%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fheliyos-mcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D)%22%2C%22password%22%3Atrue%7D%5D%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fmcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D

サーバーの初回起動時に VS Code からキーの入力を求められ、キーはシークレットストレージに保存されます。手動で設定するには、プロジェクトの .vscode/mcp.json、またはユーザー設定の mcp.json（MCP: Open User Configuration）に次の内容を追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "heliyos-api-key",
      "description": "Heliyos API key (Settings → API keys)",
      "password": true
    }
  ],
  "servers": {
    "heliyos": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@heliyos/heliyos-mcp"],
      "env": { "HELIYOS_API_KEY": "${input:heliyos-api-key}" }
    }
  }
}

Antigravity

エージェントパネルで … → MCP Servers → Manage MCP Servers → View raw config を開くか、~/.gemini/config/mcp_config.json を直接編集します（プロジェクトごとに設定する場合は .agents/mcp_config.json）。

{
  "mcpServers": {
    "heliyos": {
      "command": "npx",
      "args": ["-y", "@heliyos/heliyos-mcp"],
      "env": { "HELIYOS_API_KEY": "YOUR_HELIYOS_API_KEY" }
    }
  }
}

その他のクライアント

環境変数にキーを設定して、stdio 経由でパッケージを実行します。

HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY npx -y @heliyos/heliyos-mcp

リポジトリには、Git リポジトリからプラグインをインストールするクライアント向けに、ポータブルな Agent Plugins マニフェスト（plugin.json と mcp.json）も含まれています。これらにキーは含まれないため、クライアントがサーバーを起動するときに使用する環境で HELIYOS_API_KEY を設定してください。MCP Registry では、このサーバーは ai.heliyos/heliyos-mcp として登録されています。

ツールのタイムアウト

heliyos_ask は Heliyos からの応答を最大 90 秒待機するため、ツール呼び出しには少なくとも 120 秒を設定してください。

クライアント	設定
Codex	[mcp_servers.heliyos] テーブルで tool_timeout_sec = 120 を設定します（デフォルトは 60 です）。マーケットプレイスからプラグインとしてインストールした場合、プラグインの .mcp.json には tool_timeout_sec を指定できないため、Codex はデフォルトの 60 秒を維持します。その結果、長時間かかる heliyos_ask は 60 秒で停止します。120 秒にするには、上記の config.toml 設定を使用してください。
Claude Code	デフォルトで十分な長さです。MCP_TOOL_TIMEOUT を設定する場合は、120000 以上にしてください。たとえば、MCP_TOOL_TIMEOUT=120000 claude のようにします。
Claude Desktop	公開されている設定はありません。
Cursor	公開されているツールのタイムアウト設定はありません。
VS Code	公開されているツールのタイムアウト設定はありません。
Antigravity	公開されているツールのタイムアウト設定はありません。

クライアントが呼び出しを途中で打ち切っても、Heliyos では実行が継続します。heliyos_runs_list で実行を見つけ、heliyos_runs_get と wait: true を使って追跡してください。呼び出しごとに最大 30 秒待機します。

レート制限されたリクエスト（HTTP 429）は、Retry-After の待機時間後に 1 回再試行されます。ただし、待機時間は最大 30 秒です。そのため、制限に達した heliyos_ask の処理には約 125 秒かかることがあります。制限に近い状態でタイムアウトが発生する場合は、タイムアウトを 150 秒に延長してください。

設定

変数	必須	デフォルト	説明
HELIYOS_API_KEY	はい	なし	Heliyos API キーです。heliyos_ で始まる必要があります。
HELIYOS_BASE_URL	いいえ	https://api-prod.heliyos.ai	呼び出す Heliyos API です。https を使用する必要があります。http は localhost の場合に限り使用できます。
HELIYOS_MCP_EXPERIMENTAL	いいえ	オフ	1、true、yes または on を設定すると、以下に示す実験的なツールが追加されます。

サーバーは、1 件のレコードを JSON として返すリソーステンプレート heliyos://records/{id} と、2 つのプロンプト（1 社向けの prepare_account_review と daily_pipeline_summary）も提供します。

ツール

すべてのツールは heliyos_<resource>_<verb> という名前で、読み取り、書き込み、削除のいずれを行うかを宣言するため、クライアントは変更を加える前に確認できます。読み取りでは response_format（concise または detailed）を指定し、一覧では limit と cursor を指定します。

デフォルトで 73 個のツールがあり、HELIYOS_MCP_EXPERIMENTAL=1 を設定するとさらに 4 個追加されます。種類は read（変更なし）、write（作成または更新）、destructive（削除または除去）です。

レコード

ツール	説明	種類
heliyos_records_list	レコードの一覧を取得する	read
heliyos_records_get	レコードを取得する	read
heliyos_records_create	レコードを作成する	write
heliyos_records_update	レコードを更新する	write
heliyos_records_delete	レコードを削除する	destructive
heliyos_records_lookup	名前からレコードを検索する	read
heliyos_records_enrich	人物情報を補完する（実験的）	write

タイムラインとアクティビティ

ツール	説明	種類
heliyos_records_timeline	レコードのタイムラインを読み取る	read
heliyos_records_events	レコードの変更履歴を読み取る	read
heliyos_interactions_list	メールと会議の一覧を取得する	read
heliyos_interactions_get	メールまたは会議を取得する	read

ワークスペース、オブジェクト、フィールド

ツール	説明	種類
heliyos_organization_get	ワークスペースを取得する	読み取り
heliyos_objects_list	オブジェクトの一覧を取得する	読み取り
heliyos_objects_get	オブジェクトのフィールドを取得する	読み取り
heliyos_objects_create	カスタムオブジェクトを作成する（試験的）	書き込み
heliyos_objects_update	オブジェクトの名前または説明を変更する（試験的）	書き込み
heliyos_objects_delete	カスタムオブジェクトを削除する（試験的）	破壊的
heliyos_fields_create	オブジェクトにフィールドを追加する	書き込み
heliyos_fields_update	フィールドを変更する	破壊的
heliyos_fields_delete	フィールドを削除する	破壊的

ノート

ツール	説明	種類
heliyos_notes_list	ノートの一覧を取得する	読み取り
heliyos_notes_get	ノートを取得する	読み取り
heliyos_notes_create	ノートを作成する	書き込み
heliyos_notes_update	ノートを更新する	書き込み
heliyos_notes_delete	ノートを削除する	破壊的

タスク

ツール	説明	種類
heliyos_tasks_list	タスクの一覧を取得する	読み取り
heliyos_tasks_get	タスクを取得する	読み取り
heliyos_tasks_events	タスクのアクティビティを読み取る	読み取り
heliyos_tasks_create	タスクを作成する	書き込み
heliyos_tasks_update	タスクを更新する	書き込み
heliyos_tasks_delete	タスクを削除する	破壊的
heliyos_tasks_run	タスクでワーカーを実行する	破壊的

スカウトとシグナル

ツール	説明	種類
heliyos_scouts_list	スカウトの一覧を取得する	読み取り
heliyos_scouts_get	スカウトを取得する	読み取り
heliyos_scouts_create	スカウトを作成する	書き込み
heliyos_scouts_update	スカウトを更新する	書き込み
heliyos_scouts_delete	スカウトを削除する	破壊的
heliyos_companies_scouts_list	企業のスカウト一覧を取得する	読み取り
heliyos_companies_scouts_add	企業にスカウトを追加する	書き込み
heliyos_companies_scouts_remove	企業のスカウトを削除する	破壊的
heliyos_signals_list	シグナルの一覧を取得する	読み取り
heliyos_signals_mark_read	シグナルを既読にする	書き込み

質問、実行、レビュー

ツール	説明	種類
heliyos_ask	Heliyosに質問する	破壊的
heliyos_runs_get	実行を取得する	読み取り
heliyos_runs_list	実行の一覧を取得する	読み取り
heliyos_reviews_list	レビューの一覧を取得する	読み取り
heliyos_reviews_get	レビューを取得する	読み取り
heliyos_reviews_decide	レビューを承認または却下する	破壊的

ワーカー、トリガー、ツール

ツール	説明	種類
heliyos_workers_list	ワーカーの一覧を取得する	読み取り
heliyos_workers_get	ワーカーを取得する	読み取り
heliyos_workers_create	ワーカーを作成する	書き込み
heliyos_workers_update	ワーカーを更新する	書き込み
heliyos_workers_delete	ワーカーを削除する	破壊的
heliyos_triggers_list	ワーカーのトリガーの一覧を取得する	読み取り
heliyos_workers_tools_list	ワーカーが使用できるツールの一覧を取得する	読み取り

ナレッジベースとファイル

ツール	説明	種類
heliyos_knowledge_get	ナレッジベースを読み取る	読み取り
heliyos_knowledge_update	ナレッジベースを更新する	書き込み
heliyos_knowledge_entries_set	ナレッジエントリーを追加または変更する	書き込み
heliyos_knowledge_entries_delete	ナレッジエントリーを削除する	破壊的
heliyos_files_list	ファイルの一覧を取得する	読み取り
heliyos_files_get	ファイルを取得する	読み取り
heliyos_files_upload	ファイルをアップロードする	書き込み
heliyos_files_delete	ファイルを削除する	破壊的

ウォッチリスト

ツール	説明	種類
heliyos_watchlist_get	ウォッチリストを取得する	読み取り
heliyos_companies_watch	企業をウォッチする	書き込み
heliyos_companies_unwatch	企業のウォッチを解除する	破壊的

ラベル

ツール	機能	種類
heliyos_labels_list	ラベルグループを一覧表示します	読み取り
heliyos_labels_create	ラベルグループを作成します	書き込み
heliyos_labels_update	ラベルグループを更新します	破壊的
heliyos_labels_delete	ラベルグループを削除します	破壊的

チーム

ツール	機能	種類
heliyos_team_members_list	チームメンバーを一覧表示します	読み取り
heliyos_team_members_invite	チームメンバーを招待します	書き込み
heliyos_team_members_remove	チームメンバーを削除します	破壊的
heliyos_team_members_change_role	チームメンバーのロールを変更します	書き込み

通知設定

ツール	機能	種類
heliyos_notification_settings_get	通知設定を取得します	読み取り
heliyos_notification_settings_update	通知設定を更新します	書き込み

使用状況

ツール	機能	種類
heliyos_usage_get	クレジットの使用状況を取得します	読み取り

セキュリティ

• キーはお使いのマシンに保持されます。 サーバーは環境からキーを読み取り、ベアラートークンとして HTTPS 経由で Heliyos API（HELIYOS_BASE_URL）にのみ送信します。localhost 以外の HTTPS ではないベース URL は拒否します。
• ファイルのアップロード時にキーは送信されません。 ファイルの内容は有効期限の短い署名付きストレージ URL に送信され、そのリクエストにキーは含まれません。
• テレメトリーはありません。 サーバーはほかの場所に何も送信せず、ログも保持しません。診断情報はクライアントの stderr に出力され、エラーメッセージからキーは削除されます。
• レート制限。 API では、キーごとおよび IP アドレスごとに 1 分あたり 60 件のリクエストが許可されています。429 が返された場合、サーバーは Retry-After を待ってから 1 回だけ再試行します。
• 最小限のアクセス権限。 キーには 1 つのワークスペースの管理者権限があります。有効期限を設定し、ユーザーとマシンごとにキーを 1 つ使い、不要になったら Settings → API keys で取り消してください。
• 破壊的なツールには印が付いています。 削除やメンバーの除外は破壊的な操作として示され、エージェントスキルはエージェントに事前確認するよう指示します。

セキュリティ上の問題は、公開 Issue ではなく、GitHub security advisories から非公開で報告してください。

トラブルシューティング

表示される内容	対処方法
heliyos-mcp: Set HELIYOS_API_KEY to a Heliyos API key	クライアントからキーが渡されていません。env ブロックを確認するか、クライアントを起動したシェルで変数がエクスポートされていることを確認してください。
HELIYOS_API_KEY does not look like a Heliyos API key	値が Heliyos のキーではありません。キーは heliyos_ で始まります。コピーし直すか、新しいキーを作成してください。
UNAUTHENTICATED	キーが取り消されたか、有効期限が切れているか、入力を間違えています。Settings → API keys で新しいキーを作成してください。
FORBIDDEN_ACTION	ワークスペースのプランまたは請求状況ではその操作が許可されていないか、その操作は API キーで利用できません。
RATE_LIMITED	1 分あたりのリクエスト数が 60 件を超えています。1 分待ち、多数の単一取得リクエストではなくリスト取得を優先してください。
heliyos_ask がタイムアウトする	クライアントのツールタイムアウトを延長してください（ツールのタイムアウトを参照）。実行は継続されるため、その後に heliyos_runs_get を呼び出してください。
初回起動時にサーバーが「connecting」と表示される	初回の npx -y @heliyos/heliyos-mcp ではパッケージがダウンロードされるため、接続が遅い場合は 20〜30 秒かかり、クライアントの起動タイムアウトを超えることがあります。ターミナルから一度 npx -y @heliyos/heliyos-mcp --version を実行してキャッシュを準備してから、再接続してください。以降の起動は約 1 秒で完了します。または、タイムアウトを延長してください（Codex の startup_timeout_sec、Claude Code の MCP_TIMEOUT=60000）。
Node 16.x is too old が表示される、または fetch is not defined によりツールが失敗する	クライアントが古い Node で npx を起動しています。通常は、バージョンマネージャーのデフォルトバージョンが原因です。サーバーには Node 20 以降が必要で、検出した中から最も新しい適切な Node（nvm、fnm、n、Volta、Homebrew、PATH）で自動的に再起動します。メッセージには使用する Node が表示されます。見つからない場合は、Node 20 以降をインストールするか、nvm install 20 && nvm alias default 20 を実行してから、クライアントを再起動してください。Dock から起動したアプリでは npx が見つからない場合があります。その場合は which npx で確認したフルパスを使用してください。
試験的なツールが見つからない	HELIYOS_MCP_EXPERIMENTAL=1 を設定し、クライアントを再起動してください。

まだ解決しませんか？github.com/heliyos-ai/heliyos-mcp/issues でイシューを作成してください。キーを貼り付けないでください。

開発

要件：Node.js 20 以降と npm。その他はすべて開発用の依存関係です。

git clone https://github.com/heliyos-ai/heliyos-mcp.git
cd heliyos-mcp
npm ci
npm test                  # unit tests with a mocked Heliyos API
npm run typecheck
npm run build             # codegen, then tsc into dist/
npm run readme:tools      # regenerate the tool table above
npm run install-links     # print the Cursor and VS Code install links
npm run prepublish:check  # manifests, versions and package contents
HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY npm run smoke   # read-only checks against a real workspace

公開済みパッケージではなくローカルビルドをクライアントで実行するには、クライアントの参照先を dist/src/bin/stdio.js に設定してください。

claude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos-dev -- node /path/to/heliyos-mcp/dist/src/bin/stdio.js

ビルド方法

• src/client/openapi/ には、Heliyos API の OpenAPI ドキュメントのコピーが格納されています。npm run codegen を実行すると、zod スキーマを含む型付き操作テーブル（src/client/generated.ts）が生成され、すべてのリクエストは送信前に検証されます。
• src/tools/ では、リソースごとに 1 つのファイルを定義します。各ツールには、入力と出力のスキーマ、アノテーション（読み取り、書き込み、破壊的操作）、および 1 つまたは 2 つの API 操作を呼び出して短いテキストと structuredContent を生成するハンドラーが定義されています。
• tests/ では、msw を使ってモック API に対しすべてのツールを実行します。スナップショットテストで公開ツールの契約（名前、アノテーション、入力キー）を固定しているため、意図しない変更があるとビルドが失敗します。
• skills/heliyos/SKILL.md は Claude Code プラグインに含まれており、エージェントに各ツールを使用するタイミングを教えます。

API クライアントの更新

Heliyos API に変更があった場合は、新しい OpenAPI ドキュメントを保存して再同期してください。

curl -s https://api-prod.heliyos.ai/v1/platform/openapi.json -o /tmp/platform.json
curl -s https://api-prod.heliyos.ai/v1/auth/openapi.json -o /tmp/auth.json
HELIYOS_PLATFORM_OPENAPI=/tmp/platform.json HELIYOS_AUTH_OPENAPI=/tmp/auth.json npm run sync-openapi
npm run codegen && npm test

この 2 つの変数を設定すると、npm run prepublish:check とドリフトテストでも、バンドルされたコピーが最新の内容と一致しなくなった場合に処理が拒否されます。

リリース

リリースは、main へのプッシュごとに GitHub Actions によって公開されます（.github/workflows/publish-package.yml）。

1. CI がパッケージとマニフェストをビルド、テスト、チェックします。
2. package.json のバージョンがすでに npm に存在する場合、ワークフローは node scripts/set-version.mjs でパッチバージョンを更新します。このスクリプトは、package.json、ロックファイル、server.json、すべてのプラグインマニフェスト、src/version.ts のバージョンを同じに保ち、更新をコミットします。
3. npm の信頼済みパブリッシングを通じて来歴情報付きで npm に公開し（トークンはどこにも保存されません）、対象のバージョンが配信されるまで待機してから、MCP_PRIVATE_KEY シークレットが設定されている場合に server.json を MCP レジストリに公開します。

指定したバージョンをリリースするには、node scripts/set-version.mjs 1.2.0 を実行してコミットし、main にプッシュします。リポジトリの初回セットアップについては、CONTRIBUTING.md を参照してください。

コントリビューション

Issue とプルリクエストを歓迎します。ワークフロー、コーディング規則、ツールの追加方法については CONTRIBUTING.md を、脆弱性の報告方法については SECURITY.md をお読みください。参加することで、行動規範に同意したものとみなされます。

ライセンス

MIT