Limelink MCP Server

🚀 limelink-mcp-server

LimeLinkの動的リンク管理用のModel Context Protocol (MCP)サーバーです。Claude Code、Claude Desktop、またはMCP互換のクライアントから直接、動的リンクの作成、検索、管理ができます。

開始にAPIキーは必要ありません！ ドキュメント、SDKセットアップガイド、プロンプトテンプレートは、設定なしで使用できます。接続するだけで、AIアシスタントでLimeLinkの機能を探索し始めることができます。

✨ 主な機能

• ドキュメントリソース — AIアシスタントから直接LimeLinkのドキュメント（15ページ + インデックス）にアクセスできます — APIキー不要
• 2つのプロンプトテンプレート — リンク作成とSDKディープリンク設定のガイド付きワークフロー — APIキー不要
• 3つのツール — 動的リンクの作成、サフィックスでの検索、URLでの検索（APIキーが必要）
• インメモリキャッシュ — ドキュメント取得に1時間のTTLキャッシュがあります

APIキーなしで動作する機能

🚀 クイックスタート

APIキーなし（ドキュメントとガイド）

APIキーは必要ありません。接続するとすぐにLimeLinkのドキュメントとセットアップガイドを探索できます。

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "limelink-mcp-server"]
    }
  }
}

AIアシスタントに以下のような質問を試してみてください。

• "LimeLinkの入門ドキュメントを読む"
• "iOSでディープリンクを設定するにはどうすればいいですか？"
• "LimeLink SDKの統合ガイドを見せて"

APIキーあり（全機能）

APIキーを追加すると、リンクの作成と管理ツールを使用できます。

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "limelink-mcp-server"],
      "env": {
        "LIMELINK_API_KEY": "your_api_key_here"
      }
    }
  }
}

グローバルインストールでの使用

npm install -g limelink-mcp-server

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp-server",
      "env": {
        "LIMELINK_API_KEY": "your_api_key_here"
      }
    }
  }
}

📚 ドキュメント

Claude Code

MCPサーバーを追加する最も簡単な方法は、claude mcp addコマンドを使用することです。

# APIキーなし（ドキュメントとガイドのみ）
claude mcp add --scope user --transport stdio limelink -- npx -y limelink-mcp-server

# APIキーあり（全機能）
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_API_KEY=your_api_key_here \
  -- npx -y limelink-mcp-server

スコープオプション:

• --scope user — すべてのプロジェクトで利用可能
• --scope project — .mcp.jsonに保存されます（Gitを介してチームと共有可能）

Claude Desktopおよびその他のMCPクライアント

JSON設定をクライアントの設定ファイルに追加してください。

環境変数

LimeLinkダッシュボードからAPIキーを取得できます。APIキーなしでも、ドキュメントリソース、SDKセットアップガイド、プロンプトテンプレートは完全に利用可能です。

💻 使用例

create-link

プラットフォーム固有のディープリンク、ソーシャルプレビュー、UTMトラッキングを持つ動的リンクを作成します。

パラメータ:

Claudeでの使用例:

"https://example.com/product/123 の動的リンクをサフィックス 'product-123' で作成し、分析を有効にする"

get-link-by-suffix

サフィックスで動的リンクを検索します。

get-link-by-url

完全なURLで動的リンクを検索します。両方のURL形式からサフィックスを自動的に抽出します。

• 無料プラン: https://deep.limelink.org/{suffix}
• プロプラン: https://{project}.limelink.org/link/{suffix}

limelink://docs/index

完全なLimeLinkドキュメントインデックス (llms.txt) を返します。

limelink://docs/{slug}

個別のドキュメントページを返します。利用可能なスラッグ:

introduction, getting-started, project, application, dynamic-link, create-link, link-detail, link-management, appearance, sdk-integration, ios-sdk, android-sdk, api-integration, advanced, llm-agent

Claudeでの使用例:

"LimeLink API統合ドキュメントを読む"

Claudeは limelink://docs/api-integration にアクセスします。

create-dynamic-link

動的リンクを作成するためのガイド付きワークフローです。

setup-deep-linking

LimeLink SDKのディープリンクを設定するためのガイド付きワークフローです。

🔧 技術詳細

前提条件

• Node.js >= 18
• pnpm

セットアップ

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

ローカルで実行

LIMELINK_API_KEY=your_key node dist/index.js

テスト

pnpm test          # 単体テスト
pnpm test:e2e      # E2Eテスト（MCP stdio通信）
pnpm test:watch    # ウォッチモードでの単体テスト
pnpm test:coverage # カバレッジレポート

プロジェクト構造

src/
├── index.ts              # エントリーポイント
├── lib/
│   ├── config.ts         # 環境変数の読み込み
│   ├── cache.ts          # インメモリTTLキャッシュ
│   ├── api-client.ts     # LimeLink API HTTPクライアント
│   └── doc-fetcher.ts    # キャッシュ付きのドキュメントフェッチャー
├── tools/
│   ├── create-link.ts    # create-linkツール
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
├── resources/
│   └── documentation.ts  # ドキュメントリソース
└── prompts/
    ├── create-link-prompt.ts
    └── deep-link-prompt.ts

📄 ライセンス

MIT