关于 EcoAloha
EcoAloha 是用于查找和比较户外体验的公开免密 API 与 MCP 服务,适合行程规划 Agent 和 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 | 是 | 页面 slug 或目标 id。索引页面使用 index。 |
| type | enum | 是 | collection | destination | activity | collections | destinations | activities |
详细介绍
EcoAloha Agent 集成
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 以 @ecoaloha/sdk 的名称发布在 npm 上。
npm install @ecoaloha/sdk
npx --package=@ecoaloha/sdk ecoaloha --sandbox destinations
Python SDK 以 ecoaloha 的名称发布在 PyPI 上。需要 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 公开且无需密钥。请遵守速率限制和 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 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。