# TinyFish

TinyFish 为兼容 MCP 的 AI 助手提供网络自动化、网络搜索、内容提取和远程浏览器会话工具。托管的 MCP 服务器使用 OAuth 2.1，而可选的本地 @tiny-fish/mcp 代理支持仅本地、CI 和无头环境下的 API 密钥认证。

Canonical URL: https://a2a-mcp.org/entry/tinyfish-zh

Language: zh

Category: MCP Servers

Updated: 2026-08-18

##  关于

TinyFish 是 TinyFish Web 代理的 MCP 集成。其托管端点让兼容 MCP 的助手能够调用网页自动化、搜索、内容提取、运行管理和远程浏览器会话等功能。TinyFish 还发布了一个 MIT 许可证的 TypeScript 包 `@tiny-fish/mcp`，它充当到托管 MCP 服务的本地反向代理，而非定义自身的工具或模式。

## 主要特性

- 通过 `run_web_automation` 和 `run_web_automation_async` 实现基于目标的浏览器自动化，并通过 `get_run`、`list_runs` 和 `cancel_run` 进行运行检查与取消。
- 通过 `search` 实现网页搜索，并通过 `get_search_usage` 检查搜索使用情况。
- 通过 `fetch_content` 提取浏览器渲染的内容，并通过 `list_fetch_usage` 获取使用元数据。
- 通过 `create_browser_session`、`list_browser_sessions` 和 `close_browser_session` 实现远程 Chrome 会话，可配合 Playwright、Puppeteer 或 Selenium 进行直接控制。
- 提供批量状态和取消工具，用于管理多个自动化运行。
- 支持配置文件的自动化，可复用已保存的浏览器上下文，并可选用 TinyFish Vault 凭据处理需要重复登录的工作流。

## 使用场景

TinyFish 适用于需要根据自然语言目标浏览网站、提取实时网页内容、搜索最新信息、与表单和需要身份验证的应用交互，或者将远程浏览器会话交给自动化框架的代理。其异步运行和运行管理工具对于较耗时的工作流特别有用，调用代理可以先启动任务，稍后再轮询获取完成结果。

## 兼容性

主要服务是一个使用 Streamable HTTP 的托管 MCP 端点。TinyFish 当前文档提供了针对 Codex、Grok、Claude Code、OpenCode、Claude Desktop、ChatGPT、Cursor 和 Windsurf 的客户端级配置，并说明该服务可与其他兼容 MCP 的助手一起使用。可选的本地代理会暴露一个环回 HTTP MCP 端点，并在仓库中提供了 Claude Code、Claude Desktop、Cursor、VS Code 以及通用基于 URL 的 MCP 客户端的配置文档。

## 限制

- 使用托管 MCP 流程需要 TinyFish 账户和 OAuth 2.1 授权；TinyFish 文档说明该账户必须拥有有效订阅或积分。
- 在当前的计费模型中，搜索和内容获取工具是免费的，而代理自动化和远程浏览器会话会消耗 TinyFish 积分。
- 本地的 `@tiny-fish/mcp` 包仅为托管服务的代理，不提供 TinyFish 工具的独立离线实现。
- 本地代理需要 Node.js 22 或更高版本以及 `TINYFISH_API_KEY`。它仅绑定到环回地址，但任何能访问其监听端口的受信任本地进程都可以使用服务器持有的密钥调用自动化功能。
- 根据本地代理文档，托管服务不支持 JSON-RPC 批量数组。

## 来源

- 官方 MCP 文档：https://docs.tinyfish.ai/mcp-integration
- 身份验证：https://docs.tinyfish.ai/authentication
- 定价：https://www.tinyfish.ai/pricing
- GitHub：https://github.com/tinyfish-io/tinyfish-mcp-server
- npm：https://www.npmjs.com/package/@tiny-fish/mcp

## MCP 配置

### 前提条件

- 拥有 TinyFish 账户，并已为托管 MCP 服务订阅或购买积分
- 一个能够连接远程 HTTP MCP 服务器的 MCP 客户端（推荐使用托管设置）
- 仅在使用可选的 @tiny-fish/mcp 本地代理时，需要 Node.js >= 22
- 仅在使用可选的 @tiny-fish/mcp 本地代理时，需要 TinyFish API 密钥

### 访问要求

- 托管 MCP 身份验证在浏览器中使用 OAuth 2.1
- 可选的本地代理启动时需要 `TINYFISH_API_KEY`，并将其作为 `X-API-Key` 发送到上游
- 在当前的 TinyFish 定价模型中，搜索和获取是免费的；代理自动化和浏览器会话会消耗积分

### 配套应用或插件

名称：@tiny-fish/mcp 本地代理
安装地址：https://www.npmjs.com/package/@tiny-fish/mcp

- 全局安装：`npm install -g @tiny-fish/mcp`
- 或者直接运行而不安装：`npx @tiny-fish/mcp`
- 在环境中设置 `TINYFISH_API_KEY`。
- 启动 tinyfish-mcp，并将 MCP 客户端指向 `http://127.0.0.1:3711/mcp`。

可选。当客户端支持远程流式 HTTP 时，仓库推荐直接使用托管端点。对于仅限本地的客户端或需要在 CI、无头机器和脚本中进行 API 密钥身份验证的情况，可以使用本地代理。

### 客户端配置

#### Claude Code

传输方式：`http`

```bash
claude mcp add --transport http tinyfish https://agent.tinyfish.ai/mcp
```

- 运行文档中提供的 Claude Code 命令，以添加托管 TinyFish MCP 服务器。

身份验证：
- 首次使用时，在浏览器中完成 TinyFish OAuth 2.1 流程。

托管端点；无需本地运行 TinyFish 进程。
#### Claude Desktop

传输方式：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 使用 `https://agent.tinyfish.ai/mcp` 将 TinyFish 添加为自定义连接器，或者使用文档中基于 URL 的服务器配置。
- 编辑配置后重新启动 Claude Desktop。

身份验证：
- 当 Claude Desktop 提示进行身份验证时，在浏览器中完成 OAuth 流程。

TinyFish 推荐直接使用托管 URL。
#### Cursor

传输方式：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 将文档中的 TinyFish 条目添加到 Cursor MCP 设置中。

身份验证：
- 当提示时，在浏览器中完成 TinyFish OAuth 2.1 流程。

托管端点。
#### Codex

传输方式：`http`

```bash
codex mcp add tinyfish --url https://agent.tinyfish.ai/mcp
```

- 运行文档中提供的 Codex 命令，以添加 TinyFish。

身份验证：
- 当客户端请求授权时，完成 TinyFish OAuth 2.1 流程。

托管端点。

#### Windsurf

传输方式：`http`

```json
{
  "mcpServers": {
    "tinyfish": {
      "serverUrl": "https://agent.tinyfish.ai/mcp"
    }
  }
}
```

- 将记录的 TinyFish 服务器条目添加到 Windsurf MCP 配置中。

认证：
- 在浏览器提示时完成 TinyFish OAuth 2.1 认证流程。

托管端点。
#### VS Code

传输方式：`http`

```json
{
  "servers": {
    "tinyfish": {
      "type": "http",
      "url": "http://127.0.0.1:3711/mcp"
    }
  }
}
```

- 启动可选的 @tiny-fish/mcp 本地代理。
- 使用仓库文档中引用的 .vscode/mcp.json 配置，指向 http://127.0.0.1:3711/mcp。

该仓库记录了 VS Code 的本地代理设置。TinyFish MCP 集成页面上未记录当前特定于 VS Code 的托管配置。
#### Lovable

Lovable 的确切公共 TinyFish MCP 设置尚未记录。
#### 其他

传输方式：`http`

- 使用客户端的远程 Streamable HTTP 服务器设置，配置托管 MCP 端点 https://agent.tinyfish.ai/mcp。

认证：
- 如果客户端支持托管授权流程，完成 TinyFish OAuth 2.1 认证。

TinyFish 文档指出该端点可供支持 MCP 的助手使用，并单独记录了 Grok、OpenCode 和 ChatGPT。确切的配置语法因客户端而异。

### 授权流程

- 将 https://agent.tinyfish.ai/mcp 添加到支持的 MCP 客户端。
- 首次使用时，客户端会打开浏览器进行 OAuth 2.1 授权。
- 使用 TinyFish 帐户登录并授权连接。
- 授权信息会被缓存，以供后续会话使用。

### 环境变量

- `TINYFISH_API_KEY — 可选的本地代理所需`
- `PORT — 可选的本地代理监听端口；默认为 3711`
- `TINYFISH_UPSTREAM_URL — 可选的本地代理上游覆盖；默认为 https://agent.tinyfish.ai/mcp`

设置文档：https://docs.tinyfish.ai/mcp-integration

## Tags

- MCP
- 网络自动化
- 浏览器自动化
- 网络搜索
- 内容提取
- 流式 HTTP
- OAuth
- TinyFish

## Also known as

- TinyFish MCP
- TinyFish MCP Server
- TinyFish Web Agent MCP
- TinyFish Automation MCP

## Alternatives

- Microsoft Playwright MCP
- Browserbase MCP Server
- Firecrawl MCP Server
- Apify MCP Server
- Bright Data MCP
- AgentQL MCP

## Sources

- [Project website](https://github.com/tinyfish-io/tinyfish-mcp-server)
- [TinyFish MCP Integration](https://docs.tinyfish.ai/mcp-integration)
- [TinyFish Authentication](https://docs.tinyfish.ai/authentication)
- [TinyFish Pricing](https://www.tinyfish.ai/pricing)
- [GitHub repository](https://github.com/tinyfish-io/tinyfish-mcp-server)
- [npm package](https://www.npmjs.com/package/@tiny-fish/mcp)

Last checked: 2026-08-17