@limelink/mcp

한국어 · Documentation · Capability reference

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

開始にあたり API キーは不要です! ドキュメントと SDK セットアップガイドは、設定なしで利用できます。接続するだけで、AI アシスタントと一緒に LimeLink の機能を探索できます。

特徴

• ドキュメントリソース — LimeLink ドキュメント(15 ページ + インデックス)に AI アシスタントから直接アクセス — API キー不要

• 5 つのツール — プロファイルとプロジェクトの検出、動的リンクの作成、リンクの検索(API ツールには設定済みプロファイルが必要)

• インメモリキャッシュ — ドキュメント取得用の 1 時間 TTL キャッシュ

ランタイム

• Node.js 18 以降

• stdio トランスポートのみ対応。Remote MCP/HTTP トランスポートは非対応

• npm パッケージ: @limelink/mcp。グローバル実行ファイル: limelink-mcp

• stdout は MCP プロトコル用に予約されています。診断ログとラッパーログは stderr を使用してください

完全な運用契約については、インストールと設定 と ネットワーク動作 を参照してください。

API キーなしで利用できる機能

Related MCP server: lynxprompt-mcp

クイックスタート

API キーなし(ドキュメントとガイド)

API キーは不要です。接続して、LimeLink のドキュメントとセットアップガイドをすぐに探索できます:

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

AI アシスタントに次のように質問してみてください:

• 「LimeLink の getting-started ドキュメントを読んで」

• 「iOS のディープリンク設定はどうやるの?」

• 「LimeLink SDK 統合ガイドを見せて」

Organization プロファイルあり(全機能)

以下に示すバージョン 1 のプロファイルファイルを作成し、その絶対パスを渡します:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

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

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

設定

Claude Code

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

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

スコープオプション:

• --scope user — すべてのプロジェクトで利用可能

• --scope project — .mcp.json に保存(Git 経由でチームと共有可能)

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

クライアントの設定ファイルに JSON 設定を追加します:

プロファイルファイル

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

環境変数

LIMELINK_API_KEY と LIMELINK_PROJECT_ID は無視されます。認証情報プロファイルが設定されていない場合、API バックエンドのツールはエージェントを Organizations に誘導し、Organization API キーを発行してプロファイルファイルを設定するように指示します。プロジェクトバックエンドのツールは、Project UUID を直接受け付けます。プロファイルのオプションの projects マップは、頻繁に使用するプロジェクトの便利なエイリアスとして推奨されますが、必須ではありません。list-projects での検出後にエイリアスを追加すると便利です。プロファイルは、最初の API バックエンド呼び出し時に認証情報のイントロスペクションを通じて遅延初期化されます。エイリアスの追加を含むプロファイルファイルの変更には、MCP サーバーの再起動が必要です。

API キーは LimeLink Dashboard から取得できます。API キーがなくても、ドキュメントリソースと SDK セットアップガイドは完全に利用可能です。

ツール

list-profiles

API に接続せずに、設定済みエイリアス、Organization ラベル、デフォルトステータス、現在の初期化ステータスを一覧表示します。初期化済みプロファイルにはスコープが含まれます。API キーの値は機密情報のため、決して返されません。Organization、Project、Custom Domain、認証情報の識別子とキープレフィックスは非機密の識別子であり、API バックエンドのツール応答で有用な場合に表示されることがあります。

list-projects

選択したプロファイルの認証情報から検出された Organization 内のプロジェクトを一覧表示します。オプションの profile を受け付けます。認証情報には projects:read が必要です。

list-custom-domains

必須の project(エイリアスまたは UUID)のカスタムドメインを一覧表示します。オプションの profile を受け付けます。認証情報には domains:read が必要です。

create-link

プラットフォーム固有のディープリンク、カスタムドメイン選択、ソーシャルプレビュー、UTM トラッキングを備えた V2 Core Link を作成します。

パラメータ:

Claude での使用例:

「https://example.com/product/123 への動的リンクをサフィックス 'product-123' で作成して、アナリティクスを有効にして」

get-link-by-suffix

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

get-link-by-url

完全な URL を使用して V2 API 経由でリンクを解決します。バックエンドが、URL が Free デフォルト名前空間、プロジェクトホスト名、またはアクティブなカスタムドメインのいずれに属するかを判断します。プロジェクトセレクターやローカルのサフィックス解析は不要です。

URL は絶対 HTTPS で、パスセグメントが /{suffix} の 1 つのみで、クエリ、フラグメント、明示的なポート、認証情報を含まない必要があります。

リソース

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 にアクセスします

開発

前提条件

• Node.js >= 18

• pnpm

セットアップ

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

ローカルでの実行

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

テスト

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

プロジェクト構造

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

ライセンス

MIT