STARWARCLOUD STARWAR.AI
返回市场
火链-mcp

火链-mcp

作者：djeknet3 星标更新：2025-10-23
安装使用来源：spider==github.com

项目介绍

Firelinks MCP 服务器

Firelinks 平台上的 MCP (模型上下文协议) 服务器，允许外部大型语言模型 (LLMs) 与 Firelinks API 进行交互 - https://firelinks.cc/p/api

描述

此服务器实现了由 Anthropic 开发的 MCP 协议，并提供了一组用于与 Firelinks 平台进行工作的工具：

  • 链接管理：创建、检索、编辑短链接
  • 统计：获取详细的点击统计数据，比较时间段
  • 域名：管理自定义域名
  • 服务器：获取可用服务器列表

架构

LLM 客户端 → HTTPS (mcp.firelinks.cc) → Node.js MCP 服务器 → Firelinks API 后端

要求

  • Node.js >= 20.0.0
  • Docker 和 Docker Compose（用于容器化）
  • Firelinks API 令牌

安装

本地开发

  1. 安装依赖项：
cd mcp-server
npm install
  1. 根据 .env.example 创建 .env 文件：
cp .env.example .env
  1. 在 .env 中配置环境变量：
PORT=3000
LARAVEL_API_URL=https://firelinks.cc/api
NODE_ENV=development
  1. 启动服务器：
npm start

或者在开发模式下启动（自动重载）：

npm run dev

Docker

  1. 构建镜像：
docker build -t firelinks-mcp-server .
  1. 运行容器：
docker run -d \
  -p  3000:3000 \
  -e LARAVEL_API_URL=https://firelinks.cc/api \
  --name firelinks-mcp-server \
  firelinks-mcp-server

Docker Compose

docker-compose up -d

使用方法

端点

  • GET /health - 服务器健康检查
  • POST /mcp - 主 MCP 端点（JSON-RPC 2.0）
  • GET /sse - 用于流传输的服务器发送事件

认证

所有对 /mcp 的请求都需要在头部包含认证令牌：

Authorization: Bearer YOUR_API_TOKEN

您可以在您的 Firelinks 账户中获取 API 令牌。

与 LLM 客户端集成

Claude Desktop

添加到 Claude Desktop 配置 (claude_desktop_config.json)：

{
  "mcpServers": {
    "firelinks": {
      "url": "https://mcp.firelinks.cc/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cursor

添加到 Cursor 配置 (mcp.json)：

{
  "mcpServers": {
    "firelinks": {
      "url": "https://mcp.firelinks.cc/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

其他 MCP 客户端

连接到其他兼容 MCP 的客户端时使用：

  • URL：https://mcp.firelinks.cc/mcp
  • 传输：HTTP
  • 认证：在 Authorization 头部中的 Bearer 令牌

可用工具

链接

  1. firelinks_create_link - 创建短链接
  2. firelinks_get_link - 获取链接信息
  3. firelinks_list_links - 列出所有链接
  4. firelinks_update_link_url - 更新链接 URL
  5. firelinks_add_reserve_url - 添加备用 URL

统计

  1. firelinks_stat_days - 按天统计
  2. firelinks_stat_total - 指定时间段内的总统计
  3. firelinks_stat_links - 所有链接的统计
  4. firelinks_stat_clicks - 详细的点击统计
  5. firelinks_stat_compare - 对比两个时间段

域名

  1. firelinks_list_domains - 列出域名
  2. firelinks_create_domain - 添加域名

服务器

  1. firelinks_list_servers - 列出可用服务器

请求示例

初始化

curl -X POST https://mcp.firelinks.cc/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {},
    "id": 1
  }'

列出工具

curl -X POST https://mcp.firelinks.cc/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": 1
  }'

创建链接

curl -X POST https://mcp.firelinks.cc/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "firelinks_create_link",
      "arguments": {
        "url": "https://example.com",
        "type": "url",
        "redirect_type": 0,
        "code": "my-link"
      }
    },
    "id": 1
  }'

必需参数：

  • url - 包含 http 或 https 的有效链接
  • type - 链接类型（使用 "url" 表示网页链接）
  • redirect_type - 重定向类型：0 (301)，1 (302)，2 (303)，4 (META Refresh)

可选参数：

  • link_name - 链接名称
  • code - 自定义链接代码（必须唯一）
  • domain_id - 域名 ID
  • sub_domain - 子域名
  • keywords - 搜索关键词
  • keywords_mode - 关键词搜索逻辑（1，2 或 3）
  • group_id - 链接分组 ID
  • options - 额外设置字符串

获取统计

curl -X POST https://mcp.firelinks.cc/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "firelinks_stat_days",
      "arguments": {
        "date_from": "2024-01-01",
        "date_to": "2024-01-31"
      }
    },
    "id": 1
  }'

项目结构

mcp-server/
├── src/
│   ├── index.js              # 主 Express 服务器文件
│   ├── lib/
│   │   ├── laravel-api.js    # Laravel API 的 HTTP 客户端
│   │   └── mcp-handler.js    # MCP 协议处理器
│   └── tools/
│       ├── links.js          # 链接工具
│       ├── statistics.js     # 统计工具
│       ├── domains.js        # 域名工具
│       └── servers.js        # 服务器工具
├── package.json
├── Dockerfile
├── docker-compose.yml
├── .env.example
└── README.md

故障排除

认证错误

问题：缺少或无效的 Authorization 头部

解决方案：确保请求头部包含有效的令牌：

Authorization: Bearer YOUR_API_TOKEN

请求超时

问题：到 Laravel API 的请求超时

解决方案：

  1. 检查 Laravel API 是否可用
  2. 在 src/lib/laravel-api.js 中增加超时时间
  3. 检查容器之间的网络连接性

服务器无法启动

问题：启动时出现错误

解决方案：

  1. 查看日志：docker logs firelinks-mcp-server
  2. 确保端口 3000 没有被占用
  3. 检查环境变量是否正确

许可证

MIT

支持

如有问题和支持需求，请联系 support@firelinks.cc