Firelinks MCP

🚀 Firelinks MCP Server

Firelinksプラットフォーム用のMCP（Model Context Protocol）サーバーです。外部の大規模言語モデル（LLM）がFirelinks APIとやり取りできるようにします - https://firelinks.cc/p/api

🚀 クイックスタート

このサーバーは、Anthropicによって開発されたMCPプロトコルを実装し、Firelinksプラットフォームで作業するための一連のツールを提供します。

✨ 主な機能

• リンク管理：短縮リンクの作成、取得、編集
• 統計情報：詳細なクリック統計を取得し、期間を比較
• ドメイン：カスタムドメインの管理
• サーバー：利用可能なサーバーのリストを取得

🔧 技術詳細

アーキテクチャ

LLM client → HTTPS (mcp.firelinks.cc) → Node.js MCP Server → Firelinks API Backend

要件

• Node.js >= 20.0.0
• DockerとDocker Compose（コンテナ化用）
• Firelinks APIトークン

📦 インストール

ローカル開発

1. 依存関係をインストールします：

cd mcp-server
npm install

2. .env.exampleを元に.envファイルを作成します：

cp .env.example .env

3. .envで環境変数を設定します：

PORT=3000
LARAVEL_API_URL=https://firelinks.cc/api
NODE_ENV=development

4. サーバーを起動します：

npm start

または、自動リロードの開発モードで起動する場合は：

npm run dev

Docker

1. イメージをビルドします：

docker build -t firelinks-mcp-server .

2. コンテナを実行します：

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 - ストリーミング用のServer-Sent Events

認証

/mcpへのすべてのリクエストには、ヘッダーに認証トークンが必要です：

Authorization: Bearer YOUR_API_TOKEN

APIトークンは、Firelinksアカウントで取得できます。

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 - 2つの期間の比較

ドメイン

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

トラブルシューティング

認証エラー

問題: Missing or invalid Authorization header

解決策: リクエストヘッダーに有効なトークンが含まれていることを確認します：

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までご連絡ください。