EcoAloha について
EcoAlohaは、アウトドア体験を検索・比較する公開APIおよびMCPサーバーです。旅行プランニングエージェントやAPI連携向けで、予約と支払いはViatorで行います。
主な機能
- 01アウトドア体験の検索
- 02体験の比較
- 03認証キー不要の公開API
- 04サンドボックスデータでの読み取りテスト
活用シーン
- 01アウトドア中心の旅行計画
- 02予約前の選択肢比較
- 03サンドボックスデータを使った連携テスト
MCP 対応
Streamable HTTPで https://ecoaloha.com/mcp に接続でき、APIキーは不要です。MCPクライアントにEcoAlohaの製品ツールを提供します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://ecoaloha.com/mcpclaude mcp add --transport http arneffm-ecoaloha https://ecoaloha.com/mcp{"mcpServers":{"arneffm-ecoaloha":{"type":"http","url":"https://ecoaloha.com/mcp"}}}Cursor で開く{"servers":{"arneffm-ecoaloha":{"type":"http","url":"https://ecoaloha.com/mcp"}}}VS Code で開く{"mcpServers":{"arneffm-ecoaloha":{"type":"http","url":"https://ecoaloha.com/mcp"}}}{"mcpServers":{"arneffm-ecoaloha":{"serverUrl":"https://ecoaloha.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
12| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ページのスラッグまたは遷移先 id。インデックスページには index を使用します。 |
| type | enum | はい | collection | destination | activity | collections | destinations | activities |
詳細
EcoAloha エージェント連携
EcoAloha の公式連携リソースです。 開発者ポータルとOpenAPI 仕様をご覧ください。
MCP で接続する
https://ecoaloha.com/mcp で Streamable HTTP を使用します。API キーは不要です。
Smithery の公式 EcoAloha 掲載ページをご覧ください。
ドキュメント専用のサーバーは https://ecoaloha.com/mcp/docs です。
どちらのエンドポイントも、ステートレス MCP 2026-07-28 とレガシークライアントをサポートしています。params._meta にプロトコルバージョンとクライアントの機能を含め、一致する MCP-Protocol-Version と Mcp-Method ヘッダーを送信してください。名前付きツールの呼び出しには Mcp-Name も必要です。
どちらのエンドポイントも Webhook Events をサポートしていません。公開鍵不要のアクセスでは、認証済みのサブスクリプション所有者を特定できないためです。コールバック署名シークレットを使っても、アカウントへのアクセス権は付与されません。
サーバーカードに製品のツールが記載されています。
公式 MCP Registry の掲載ページは、デプロイ済みサーバーとは別に公開されています。server.json はサーバーのリリース 1.2.0 を記述しています。プラグインと SDK のバージョンはそれぞれ独立しています。
スキルをインストールする
npx skills add ArneFfm/ecoaloha-agents
- ecoaloha-trip-planning:アウトドア体験を検索、比較します。
- ecoaloha-api-integration:HTTP API または MCP サーバーを統合、テストします。
ルートの plugin.json と mcp.json も Agent Plugin を構成します。
SDK と CLI
インストール可能なパッケージはリリース 0.1.0からダウンロードできます。
JavaScript SDK と CLI は npm で @ecoaloha/sdk として公開されています。
npm install @ecoaloha/sdk
npx --package=@ecoaloha/sdk ecoaloha --sandbox destinations
Python SDK は PyPI で ecoaloha として公開されています。Python 3.10 以降が必要です。
python3 -m pip install ecoaloha
このチェックアウトからインストールすることもできます。
npm install ./packages/sdk-js
python3 -m pip install ./packages/sdk-python
node packages/sdk-js/cli.js --sandbox destinations
Go SDK は標準ライブラリを使用します。
go get github.com/ArneFfm/ecoaloha-agents/packages/[email protected]
Go ガイドをご覧ください。
JavaScript ガイドとPython ガイドをご覧ください。
安全性と利用範囲
API は公開されており、API キーは不要です。レート制限と Retry-After を遵守してください。 ライブデータの利用にはパートナー資格が必要です。AGENT_ACCESS_NOT_APPROVED の場合、再試行したり回避したりしないでください。 読み取り専用のテストには、https://ecoaloha.com/api/sandbox/v1 の架空のフィクスチャを使用してください。 予約と支払いは Viator で行います。価格は目安です。アフィリエイトリンクであることを明示してください。
公開
手動ワークフローでは、MCP の掲載情報と SDK パッケージを個別に公開します。
公開後、パッケージのバージョンは変更できません。事前にパブリッシャーアカウントを設定する必要があります。
PyPI の場合、プロジェクト ecoaloha、所有者 ArneFfm、リポジトリ ecoaloha-agents、ワークフロー publish-pypi.yml を指定して、保留中の信頼できるパブリッシャーを登録してください。
npm の場合、@ecoaloha を所有するアカウントで最初のリリースを公開してから、ワークフロー publish-npm.yml を信頼できるパブリッシャーとして設定してください。
手動の publish-go.yml ワークフローは、変更できない Go モジュールタグをテストして公開します。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。