Clarity MCP Bootleg Market

Clarity MCP 地下市场

将浏览器流量转化为工具调用。把网络请求偷偷带进 MCP。

这到底是做什么的？

需要获取一些模型上下文协议（MCP）时，就来 Clarity。我们的服务会将从 HAR 文件中提取的 Web API 与 Claude 等 AI 助手连接起来。可以把它看成一种“借用”网站功能，并将其转化为 AI 可用功能的方式。

工作原理

sequenceDiagram
    participant Client as MCP Client (Claude)
    participant Server as Clarity Server
    participant Backend as Clarity Backend
    participant API as Target Web APIs

    note over Client,API: HAR File Processing
    Backend->>Backend: Process HAR file
    Backend->>Backend: Extract API endpoints
    Backend->>Backend: Generate tools with AI
    Backend->>Backend: Store in database

    note over Client,API: Runtime Flow
    Client->>Server: Connect via stdio
    Client->>Server: ListTools request
    Server->>Backend: Forward request
    Backend->>Server: Return available tools
    Server->>Client: Deliver tools to client

    Client->>Server: CallTool request
    Server->>Server: Transform tool name
    Server->>Backend: Forward to backend
    Backend->>API: Execute API call
    API->>Backend: Return response
    Backend->>Server: Return result
    Server->>Client: Deliver to client

安装

# Install the package
npm install -g @lekt9/clarity-mcp

# Set up your credentials
export CLARITY_API_KEY=your_api_key
# Optional: Specify a specific MCP ID if you have multiple MCPs
export CLARITY_MCP_ID=your_mcp_id

# Run the server
clarity-mcp

创建 MCP

要从 HAR 文件创建自己的模型上下文协议：

1. 访问 https://www.theclarityproject.net
2. 上传 HAR 文件
3. 平台会处理该文件并生成所需的工具
4. 从网站获取 API 密钥

地下 MCP 市场

高级 Agent 工具

MCP 是 AI Agent 梦寐以求的秘诀。这些模型上下文协议是强大的工具，Agent 会用它们与外部服务交互并获取实时数据。没有它们，AI 就会被困在自己的泡泡里。

穿上设计师服装的 API

说实话，MCP 不过是穿上华丽外衣的 API。它们和其他 API 一样遵循 OpenAPI 规范，只是包装得更适合 AI 使用。同样的产品，不同的包装——纯粹是营销天才之作。

逆向工程提取精华

每个网站都在不断发送网络请求。借助合适的工具，你可以捕获这些请求，对其进行逆向工程，并创建一份它们 API 的盗版副本。这就像复印别人的高级内容。

从流量到高级 MCP

我们的系统会将普通 HAR 文件转化为高质量 MCP，任何 AI Agent 都愿意为此支付高价。我们会分析端点、参数和响应，创建工具可使用的完美副本。

提示：AI Agent 使用工具时，会通过 MCP 发起 API 调用。通过创建这些协议，你可以扩展 AI 的能力，让它与几乎任何数字服务交互。

偷运指南

HAR（HTTP Archive）文件会记录浏览器与网站交互时发出的所有网络请求。按照以下步骤创建 HAR 文件：

第 1 步：打开开发者工具

右键单击网页任意位置，然后选择“检查”或“检查元素”。也可以使用以下键盘快捷键：

• Chrome/Edge/Firefox（Windows）：F12 或 Ctrl+Shift+I
• Chrome/Edge/Firefox（Mac）：Option+Cmd+I
• Safari（Mac）：先启用“开发”菜单（Safari > 偏好设置 > 高级 > 显示“开发”菜单），然后按 Option+Cmd+I

第 2 步：记录网络活动

在开发者工具面板中，打开“网络”标签页。

• 确保录制处于启用状态（通常显示为红色圆形图标）。
• 勾选“保留日志”选项，以便在页面加载时保留请求记录。
• 可选：使用清除图标清除现有日志，让捕获结果更整洁。
• 在网站上执行会触发你想捕获的 API 调用的操作（例如，登录、加载数据、提交表单）。

在网站上充分交互，确保记录所有需要的请求。

第 3 步：导出 HAR 文件

捕获所需活动后，在网络请求列表中的任意位置单击右键。

• 选择“将所有内容另存为 HAR”（或类似措辞，例如“导出 HAR...”）。
• 选择保存 .har 文件的位置。

现在，你可以使用 Clarity 网站上的上传工具上传此 HAR 文件。

重要：HAR 文件可能包含 Cookie、身份验证令牌和个人数据等敏感信息。请安全处理，避免公开分享。

在 Claude 中使用

1. 安装 Claude 桌面应用
2. 打开 Claude 设置并进入 MCP 部分
3. 使用以下命令添加新的 MCP 服务：

   npx -y @smithery/cli@latest install @lekt9/clarity-mcp --claude
   

4. 开始与 Claude 对话，并使用 Clarity MCP 提供的工具

环境变量

• CLARITY_API_KEY：用于向 Clarity 后端进行身份验证的 API 密钥
• CLARITY_MCP_ID：可选的 MCP ID，用于指定要使用的 MCP（适用于拥有多个 MCP 的情况）
• NEXTJS_APP_URL：Clarity 后端的 URL（默认为 https://clarity.org/）

技术细节

架构

该服务采用简单的代理架构：

1. MCP 协议处理：实现 MCP 协议以进行客户端通信
2. 请求转发：将客户端请求转发到 Clarity 后端
3. 响应转换：转换响应，使其符合 MCP 协议要求

核心组件

• 服务类：使用 MCP SDK 实现的主服务
• 请求处理器：用于处理 ListTools 和 CallTool 请求
• 名称转换：用于在不同命名规范之间转换的函数
• 错误处理：正确传递和处理错误

开发

要在开发模式下运行服务：

# Clone the repository
git clone https://github.com/lekt9/clarity-mcp.git
cd clarity-mcp

# Install dependencies
npm install

# Build the server
npm run build

限制

• 服务需要有效的 API 密钥才能向后端发送经过身份验证的请求
• 工具执行取决于 Clarity 后端是否可用
• 服务不会缓存工具定义或结果

许可证

MIT