tinyfish-mcp

一个基于 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_KEY	TinyFish API Key（必填）	—	通用
SEARCH_EXCLUDED_DOMAINS	额外排除的搜索域名列表，逗号分隔	—	通用
AUTH_TOKEN	鉴权 Token	—	HTTP
AUTH_TOKENS	多 Token（逗号分隔）	—	HTTP
AUTH_ENABLED	鉴权开关	true	HTTP
RATE_LIMIT_ENABLED	限流开关	true	HTTP
RATE_LIMIT_WINDOW	限流窗口（ms）	60000	HTTP
RATE_LIMIT_MAX	窗口内最大请求数	30	HTTP
PORT	HTTP 端口	3000	HTTP

文档

• 部署指南 — Docker / Vercel / Cloudflare Workers 部署
• 使用指南 — 详细配置与 MCP 客户端接入
• 设计文档 — 架构设计与技术方案

🛠️ 开发

依赖要求

• node >=20

常用命令

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

👤 作者

CaoMeiYouRen

• Website: https://blog.cmyr.ltd/
• GitHub: @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