Limelink MCP Server

🚀 limelink-mcp-server

limelink-mcp-server 是一個用於 LimeLink 動態鏈接管理的 模型上下文協議 (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}

返回單個文檔頁面。可用的 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      # 端到端測試（MCP 標準輸入輸出通信）
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