YourICP

YourICP MCP 服务

这是 YourICP 联系人信息补充和受众定位 API 的官方开源 Model Context Protocol （MCP）服务。它可让 Claude 等 AI 助手直接通过对话补充联系人信息并构建受众。

---

两种运行方式

	此仓库（@youricp/mcp）	托管连接器
传输方式	stdio，在你的计算机上运行	Streamable HTTP
身份验证	粘贴 API 令牌	OAuth 2.0 + PKCE，通过浏览器登录
工具	联系人信息补充	信息补充和受众构建
计费	你现有的 YourICP 套餐	按使用量付费，或使用你的套餐
设置	编辑 JSON 配置文件	粘贴一个 URL

**除非你特别希望自行运行代码，否则请使用托管连接器。**它无需安装、始终保持最新，也是唯一提供受众构建工具的选项：

https://mcp.youricp.com/sse

在 Claude 中通过 Settings → Connectors → Add custom connector 添加。有关可以向它提出的问题，请参阅连接器用户指南。

**如果你想阅读或修改代码、可自托管、使用自己的令牌完全离线运行，或使用仅支持 stdio 的客户端，请使用此仓库。**这是一个刻意保持精简的参考实现——无需支付、OAuth 或托管基础设施。

---

工具

工具	描述
set_auth_token	为此会话设置 YourICP 身份验证令牌
set_token	set_auth_token 的已弃用别名
submit_lookup	按电子邮件地址或 LinkedIn URL 补充联系人信息（返回 jobId）
check_lookup	查询 jobId 对应的信息补充结果

---

要求

• Node.js 18+
• YourICP 身份验证令牌——可在 app.youricp.com 获取

快速开始（无需安装）

直接使用 npx 运行——无需克隆或全局安装：

YOURICP_AUTH_TOKEN=your_auth_token_here npx @youricp/mcp

与 Claude Desktop 搭配使用

将以下内容添加到 claude_desktop_config.json——npx 会自动获取并运行服务：

{
  "mcpServers": {
    "youricp": {
      "command": "npx",
      "args": ["-y", "@youricp/mcp"],
      "env": {
        "YOURICP_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

重启 Claude Desktop 后，YourICP 工具就会显示出来。

全局安装（可选）

npm install -g @youricp/mcp
YOURICP_AUTH_TOKEN=your_auth_token_here youricp-mcp

从源代码构建

git clone https://github.com/youricp/mcp-server.git
cd mcp-server
npm install
YOURICP_AUTH_TOKEN=your_auth_token_here npm start

或者将 .env.example 复制为 .env 并填写内容，然后运行 npm start。

---

配置

变量	默认值	描述
YOURICP_API_URL	https://app.youricp.com	YourICP API 的基础 URL
YOURICP_AUTH_TOKEN	(none)	你的 YourICP 身份验证令牌
YOURICP_API_TOKEN	(none)	YOURICP_AUTH_TOKEN 的已弃用别名。仍会读取，但会记录弃用提示。

两种令牌

YourICP 用“令牌”一词指代两种互不相关的事物，因此此服务会始终明确说明所指的是哪一种：

• 身份验证令牌——用于证明你身份的 API 凭据。YOURICP_AUTH_TOKEN 和 set_auth_token 设置的就是这种令牌。
• 计费令牌——YourICP 用于支付信息补充工作的预付货币，100 个计费令牌 = $1.00。此参考服务不会使用计费令牌。

参与贡献

欢迎贡献！请阅读 CONTRIBUTING.md 和我们的行为准则。如需报告安全问题，请参阅 SECURITY.md。

许可证

MIT © YourICP