filoo-mcp

@filooapp/mcp-server

filoo.app 的官方 MCP 服务——一款内置点击跟踪功能、面向 AI Agent 的 URL 缩短工具。将它接入 Claude Desktop、Cursor 或任何其他 Model Context Protocol 客户端，Agent 就能通过 8 个一流工具缩短 URL、管理链接并查看扫描分析数据。

如果你正在寻找“MCP 服务 URL 缩短工具”、“Claude URL 缩短工具”、“Cursor 链接缩短工具”，或是让 AI Agent 拥有自己的短链接命名空间的方法，那就是它了。

什么是 filoo

filoo 是一款 API 优先的 URL 缩短工具，专为人类和 Agent 打造。每个链接都隶属于一个用户名（filoo.app/{username}/{slug}），附带二维码，并跟踪点击数据，包括国家、设备、引荐来源和来源细分。agents 套餐提供 50,000 个活跃链接、每天 5,000 个新链接、无限个用户名，以及每分钟 1,000 次请求的 API 速率限制，专为大量 Agent 可不受限流影响地密集调用 API 而设计。

文档和定价：https://filoo.app/api

安装

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "filoo": {
      "command": "npx",
      "args": ["-y", "@filooapp/mcp-server"],
      "env": {
        "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop。你的 Agent 现在可以使用 8 个 filoo 工具了。

Cursor

在 Cursor 设置 → MCP 中，添加一个新服务：

{
  "filoo": {
    "command": "npx",
    "args": ["-y", "@filooapp/mcp-server"],
    "env": { "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx" }
  }
}

通用 MCP 客户端（stdio）

FILOO_API_KEY=flo_live_xxxxxxxxxxxx npx -y @filooapp/mcp-server

该进程按照 MCP 规范通过 stdio 使用 JSON-RPC 进行通信。

本地安装

npm install -g @filooapp/mcp-server
FILOO_API_KEY=flo_live_xxxxxxxxxxxx mcp-server-filoo

配置

环境变量	必需	描述
FILOO_API_KEY	是	你的 filoo API 密钥，以 flo_live_ 开头。可在 https://filoo.app/dashboard/api 获取（pro、agents 或 lifetime 套餐）。
FILOO_API_BASE	否	覆盖 API 基础 URL。默认为 https://filoo.app/api/v1。

8 个工具

每个工具都与一个 filoo REST 端点一一对应。下面的描述是 LLM 在决定调用哪个工具时会读取的内容。

filoo_me

获取已认证用户的账户信息：套餐、用户名、boost 点数和限额。

提示词示例：“我的 filoo 套餐是什么？我还能创建多少个链接？”

filoo_usage

查看今日用量与配额：今天创建的链接数、今天的 API 调用次数、活跃链接数与上限。

提示词示例：“我的 filoo 每日限额还剩多少？”

filoo_list_usernames

列出你拥有的所有用户名，并指出哪个是主要用户名。

提示词示例：“列出我所有的 filoo 用户名。”

filoo_create_link

创建新的短链接。参数：destination（必需）、slug?、username?、label?。

提示词示例：“将 https://example.com/very-long-launch-page 缩短，使用我的‘agency’用户名，slug 为‘q4-launch’。”

filoo_list_links

按游标分页列出你的链接，最新的排在最前。参数：limit?（最多 100）、cursor?。

提示词示例：“显示我最近的 20 个 filoo 链接。”

filoo_get_link

按代码获取一个链接。参数：code（格式为 username:slug）。

提示词示例：“filoo 链接 agency:q4-launch 指向哪里？”

filoo_update_link

更改链接的目标地址或重命名链接，而不改变其短 URL。参数：code、destination?、label?、active?。

提示词示例：“将 filoo 链接 agency:q4-launch 指向新的落地页 https://example.com/launched。”

filoo_delete_link

永久删除一个短链接。参数：code。

提示词示例：“删除 filoo 链接 agency:old-promo。”

filoo_link_stats

查看链接的点击总数、独立访客数、机器人点击数、热门国家和热门来源。参数：code。

提示词示例：“filoo 链接 agency:q4-launch 的表现如何？显示热门国家和来源。”

获取 API 密钥

1. 在 https://filoo.app 注册
2. 升级到 agents 套餐（50,000 个链接、每天 5,000 次、每分钟 1,000 次请求）——该套餐专为 AI Agent 工作负载打造。pro 和 lifetime 套餐也提供 API。
3. 前往 https://filoo.app/dashboard/api 并创建密钥。密钥以 flo_live_ 开头。
4. 将其粘贴到 MCP 客户端配置中的 FILOO_API_KEY 下。

完整 API 参考：https://filoo.app/api

开发

git clone https://github.com/filooapp/mcp-server
cd mcp-server
npm install
npm run build
FILOO_API_KEY=flo_live_xxx node dist/index.js

许可证

MIT © 2026 filoo