LinkedIn MCP Server

LinkedIn MCP 服务

一个模型上下文协议（MCP）服务，可让 AI 助手访问 LinkedIn 官方 API。通过任何兼容 MCP 的客户端，使用自然语言创建帖子、管理活动并与 LinkedIn 互动。

仅使用官方 API。 不进行抓取，不使用非官方端点，不会带来账户风险。

功能

自助工具（无需 LinkedIn 审批）

工具	描述
linkedin_auth_start	启动 OAuth 2.0 身份验证流程
linkedin_auth_callback	使用授权码完成 OAuth
linkedin_auth_logout	撤销令牌并退出登录
linkedin_get_my_profile	获取你的 LinkedIn 个人资料（姓名、标题、照片、电子邮件）
linkedin_get_my_email	获取你的电子邮件地址
linkedin_get_auth_status	检查身份验证状态
linkedin_get_rate_limits	查看 API 速率限制使用情况
linkedin_create_post	创建文本、文章或图片帖子
linkedin_delete_post	删除你的帖子
linkedin_create_comment	评论帖子
linkedin_react_to_post	对帖子作出回应（赞、庆祝、支持、喜爱、觉得有见地、觉得好笑）
linkedin_upload_image	上传帖子图片
linkedin_list_my_posts	列出通过此服务创建的帖子，并提供用于引用的 URN
linkedin_create_event	创建 LinkedIn 活动
linkedin_get_event	获取活动详情

架构亮点

• OAuth 2.0 - 使用持久化令牌存储进行安全身份验证
• 会话自动恢复 - 服务重启后无需重新进行身份验证即可恢复（令牌过期前）
• 帖子历史跟踪 - 在本地 SQLite 日志中记录通过此服务创建的帖子，便于查找和删除
• 自适应速率限制 - 根据响应头学习 LinkedIn 的实际限制
• 自动重试 - 对暂时性故障（429、5xx）采用指数退避
• 能力检测 - 仅公开与你获准使用的权限范围相匹配的工具
• API 版本控制 - 适配 LinkedIn 每月轮换的 API 版本

前置条件

1. Node.js 20+
2. LinkedIn 开发者应用（请参阅下方的设置步骤）

LinkedIn 应用设置

步骤 1：创建 LinkedIn 开发者应用

1. 前往 linkedin.com/developers/apps 并登录
2. 点击 Create app
3. 填写必填字段：
   • App name：选择任意名称（例如“我的 MCP LinkedIn”）
   • LinkedIn Page：选择你的 LinkedIn 主页；如有需要，也可以创建一个
   • Privacy policy URL：可填写你的网站 URL 或占位 URL
   • App logo：上传任意图片（必填）
4. 勾选法律协议框，然后点击 Create app

步骤 2：获取 Client ID 和 Client Secret

1. 创建应用后，你会进入应用设置页面
2. 转到 Auth 选项卡
3. 复制 Client ID——配置时需要用到
4. 复制 Client Secret（点击眼睛图标以显示）——同样需要用到

步骤 3：添加重定向 URL

1. 仍在 Auth 选项卡中，向下滚动到 OAuth 2.0 settings
2. 在 Authorized redirect URLs for your app 下，点击 Add redirect URL
3. 输入：http://localhost:3000/callback
4. 点击 Update 保存

重要：重定向 URL 必须完全匹配，包括协议（http://）、端口（:3000）和路径（/callback）。末尾不能有斜杠。

步骤 4：启用所需产品

1. 前往应用页面上的 Products 选项卡
2. 申请使用以下两个产品：
   • Sign In with LinkedIn using OpenID Connect ——点击 Request access，查看条款并接受
   • Share on LinkedIn ——点击 Request access，查看条款并接受
3. 自助使用的申请通常会立即获批

验证：启用后，返回 Auth 选项卡。在 OAuth 2.0 scopes 下，你应看到：openid、profile、email、w_member_social。

快速开始

1. 安装

git clone https://github.com/souravdasbiswas/linkedin-mcp-server.git
cd linkedin-mcp-server
npm install
npm run build

2. 配置 MCP 客户端

适用于 Claude Code（推荐）：

claude mcp add linkedin \
  -e LINKEDIN_CLIENT_ID=your_client_id \
  -e LINKEDIN_CLIENT_SECRET=your_client_secret \
  -- node /path/to/linkedin-mcp-server/dist/index.js

或者手动添加到 ~/.claude.json：

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

适用于 Claude Desktop，添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

将 your_client_id 和 your_client_secret 替换为步骤 2 中获取的值。

3. 进行身份验证

连接后，告诉你的 AI 助手：

“使用 LinkedIn 进行身份验证”

助手会生成一个 OAuth URL。流程如下：

1. 在浏览器中打开该 URL
2. 登录 LinkedIn，然后点击 Allow 授权应用
3. LinkedIn 会重定向到 http://localhost:3000/callback?code=XXX&state=YYY
4. 由于没有本地服务在监听，你会看到“找不到页面”错误——这是正常的
5. 从浏览器地址栏复制完整 URL，并粘贴回助手
6. 助手会提取 code 和 state 参数并完成身份验证

首次完成身份验证后，你的会话会在服务重启后继续保留（令牌有效期为 60 天）。只有令牌过期时才需要重新进行身份验证。

4. 开始使用

提示词示例：

• “在 LinkedIn 上发布：刚刚推出了一项新功能，可将 API 延迟降低 40%”
• “列出我的 LinkedIn 帖子”——查看你通过该服务发布的所有帖子
• “删除我最近发布的 LinkedIn 帖子”
• “为我们的团队聚会创建 LinkedIn 活动，时间是下周五下午 2 点”
• “用庆祝表情回应这条 LinkedIn 帖子”
• “我的 LinkedIn 个人资料信息是什么？”

环境变量

变量	必需	默认值	描述
LINKEDIN_CLIENT_ID	是	-	LinkedIn 应用客户端 ID
LINKEDIN_CLIENT_SECRET	是	-	LinkedIn 应用客户端密钥
LINKEDIN_REDIRECT_URI	否	http://localhost:3000/callback	OAuth 重定向 URI
LINKEDIN_MCP_DATA_DIR	否	~/.linkedin-mcp	令牌存储目录
LINKEDIN_API_BASE_URL	否	https://api.linkedin.com	API 基础 URL（可覆盖以进行测试）
LINKEDIN_AUTH_BASE_URL	否	https://www.linkedin.com/oauth/v2	身份验证基础 URL

开发

# Install dependencies
npm install

# Type check
npm run typecheck

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run with coverage
npm run test:coverage

# Lint
npm run lint

# Dev mode (tsx, no build needed)
npm run dev

测试架构

测试全部通过模拟 LinkedIn API 服务运行，不会发起真实的 API 调用。

层级	测试内容	文件
单元测试	身份验证、PKCE、令牌存储、速率限制器、错误、功能	tests/unit/
集成测试	通过内存传输进行完整的 MCP 协议流程测试	tests/integration/
契约测试	请求/响应结构是否符合 LinkedIn API 规范	tests/contract/

项目结构

src/
  index.ts              # Entry point, stdio transport
  server.ts             # MCP server wiring
  auth/
    oauth2.ts           # OAuth 2.0 flow + token exchange
    token-store.ts      # SQLite token persistence + session auto-restore
    pkce.ts             # PKCE challenge generation (available for public clients)
    tools.ts            # Auth MCP tools
  client/
    api-client.ts       # HTTP client with retry
    rate-limiter.ts     # Adaptive rate limiting
    version-manager.ts  # LinkedIn API versioning
    errors.ts           # Structured error types
    post-history.ts     # Local post tracking (SQLite)
  capabilities/
    detector.ts         # Scope-based capability detection
  modules/
    profile/tools.ts    # Profile reading tools
    posting/tools.ts    # Post creation/management tools
    events/tools.ts     # Event management tools
  types/
    linkedin.ts         # LinkedIn API type definitions
    config.ts           # Server configuration types

限制

以下是 LinkedIn API 的限制，并非服务本身的限制：

• 无法读取他人资料——只能读取已通过身份验证的用户自己的资料
• 无法搜索用户——没有公开搜索 API
• 无法发送消息——仅向 Sales Navigator 合作伙伴开放
• 无法读取动态消息——r_member_social 范围不开放
• 无法访问联系人——只有获批 Marketing API 后才能获取联系人数量
• 速率限制——每天约 500 次应用调用，每位成员每天约 100 次（开发层级）

扩展到 Pro 层级

如果你的 LinkedIn 应用已获批使用 Community Management API 或 Advertising API，那么当你使用相应范围进行身份验证时，服务的功能检测会自动启用其他模块。模块化架构支持添加新的 API 模块，而无需修改核心服务。

License

MIT