convez.ai
MCP ServerBusca & PesquisaIntermediário
CaoMeiYouRen

TinyFish MCP — Servidor de Busca Web

CaoMeiYouRen/tinyfish-mcp

Busca web e scraping de conteúdo para Claude e outros agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP baseado na API gratuita TinyFish que fornece busca web em tempo real e extração de conteúdo para assistentes IA. Suporta integração via Stdio (local) ou HTTP (remoto) com autenticação, rate limiting e filtro de domínios de baixa qualidade.

Instalação

$npx convez-ai CaoMeiYouRen/tinyfish-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 2 semanas
Versão
v1.1.3
Issues abertas
7
Contribuidores
4

Casos de uso

  • Assistentes IA com capacidade de pesquisa web em tempo real
  • Automação de coleta e análise de conteúdo de URLs específicas
  • Integração de busca em aplicações multi-agente distribuídas

Veredito

MCP server maduro e bem documentado para integração de busca web em ecossistema Claude. Implementação limpa em TypeScript com suporte dual (Stdio/HTTP), autenticação e limitação de taxa, ideal para produção. Requer API key TinyFish e Node.js ≥20.

README

A tradução para o português deste README ainda está na fila.

一个基于 TinyFish 免费搜索 API 的 MCP(Model Context Protocol)服务,为 AI 助手提供实时网络搜索与网页内容获取能力。支持 Stdio 和 HTTP 两种传输方式接入。

功能

  • 网络搜索 — 通过 search 工具进行关键词搜索,返回标题、摘要、URL 等结构化结果
  • 低质域名过滤 — 默认过滤一批内容农场和低原创价值站点,并支持按请求或环境变量追加排除域名
  • 网页内容抓取 — 通过 fetch 工具获取指定 URL 的完整网页内容(Markdown / HTML / JSON)
  • 双协议支持 — Stdio 模式(本地进程)和 HTTP 模式(远程服务)均可
  • 鉴权保护 — HTTP 模式下支持 Bearer Token 鉴权,可配置多个 Token
  • 速率限制 — HTTP 模式下内置限流保护,防止接口滥用
  • 多云部署 — 支持 Docker、Vercel 等多种部署方式

可用工具

工具名描述
search网络搜索,返回结构化结果(标题、URL、摘要)
fetch获取指定 URL 的完整网页内容,支持 Markdown/HTML/JSON 格式

快速开始

准备

  1. 前往 agent.tinyfish.ai/api-keys 获取 API Key
  2. 设置环境变量 TINYFISH_API_KEY

Stdio 模式(推荐用于个人开发)

在 MCP 客户端(Claude Desktop / Cursor / Windsurf 等)配置文件中添加:

{
  "mcpServers": {
    "tinyfish-search": {
      "command": "npx",
      "args": ["-y", "tinyfish-mcp"],
      "env": {
        "TINYFISH_API_KEY": "<your-api-key>"
      }
    }
  }
}

HTTP 模式(推荐用于团队共享)

# 1. 创建 .env 文件
cat > .env << EOF
TINYFISH_API_KEY=<your-api-key>
AUTH_TOKEN=<your-auth-token>
EOF

# 2. 启动服务
npx -y tinyfish-mcp-server
# 服务运行在 http://localhost:3000

在 MCP 客户端中配置:

{
  "mcpServers": {
    "tinyfish-search": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer <your-auth-token>"
      }
    }
  }
}

环境变量

变量名说明默认值适用模式
TINYFISH_API_KEYTinyFish API Key(必填)—通用
SEARCH_EXCLUDED_DOMAINS额外排除的搜索域名列表,逗号分隔—通用
AUTH_TOKEN鉴权 Token—HTTP
AUTH_TOKENS多 Token(逗号分隔)—HTTP
AUTH_ENABLED鉴权开关trueHTTP
RATE_LIMIT_ENABLED限流开关trueHTTP
RATE_LIMIT_WINDOW限流窗口(ms)60000HTTP
RATE_LIMIT_MAX窗口内最大请求数30HTTP
PORTHTTP 端口3000HTTP

文档

🛠️ 开发

依赖要求

  • node >=20

常用命令

pnpm install       # 安装依赖
pnpm run dev       # 开发模式
pnpm run build     # 编译
pnpm run typecheck # 类型检查
pnpm run lint      # 代码检查
pnpm run test      # 运行测试

👤 作者

CaoMeiYouRen

🤝 贡献

欢迎 贡献、提问或提出新功能!如有问题请查看 issues page. 贡献或提出新功能可以查看contributing guide.

💰 支持

如果觉得这个项目有用的话请给一颗⭐️,非常感谢

🌟 Star History

Star History Chart

📝 License

Copyright © 2026 CaoMeiYouRen. This project is MIT licensed.


This README was generated with ❤️ by cmyr-template-cli

Ver o original no GitHub

Bom para

Relacionados