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