mcp-server

用途

@dealx/mcp-server 是 DealX 平台的 Model Context Protocol (MCP) 服务器。它通过实现 MCP 规范，为 LLM 提供标准化接口，使其能够与 DealX 平台交互。当前主要功能是搜索广告，未来计划添加更多功能。

主要能力

当前仅支持搜索广告（search_ads），参数包括：query（搜索字符串，可选）、sort（排序，如 "-created" 表示最新优先，可选）、offset（分页偏移，从 1 开始，默认 1）、limit（每页结果数，最大 100，默认 30）。未来计划实现的功能有：create_ad（创建广告）、edit_ad（编辑广告）、delete_ad（删除广告）、get_threads（获取广告讨论线程）、create_thread（创建讨论线程）。

使用方式

环境要求

Node.js (v20 或更高版本)
npm (v11 或更高版本)

安装

可通过 npm 安装：npm install @dealx/mcp-server 或使用 npx 直接运行。

与 LLM 集成配置

需要将服务器添加到 LLM 的 MCP 配置文件中。例如 Claude Desktop 的配置路径： macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json Cline (VS Code 扩展): ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

在 mcpServers 部分添加：

{
  "mcpServers": {
    "dealx": {
      "command": "npx",
      "args": ["-y", "@dealx/mcp-server"],
      "env": {
        "DEALX_API_URL": "https://dealx.com.ua"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

开发安装

克隆仓库：git clone <repository-url> 然后 cd dealx/mcp
安装依赖：npm install
基于 .env.example 创建 .env 文件：cp .env.example .env
编辑 .env 文件设置适当值，例如：

DEALX_API_URL=http://localhost:3001
MCP_SERVER_PORT=3100
LOG_LEVEL=info

构建服务器：npm run build

启动服务器

全局安装后：node node_modules/@dealx/mcp-server/build/index.js
使用 npx：npx -y @dealx/mcp-server
带环境变量：DEALX_API_URL=https://dealx.com.ua npx -y @dealx/mcp-server
开发模式：npm start

使用示例

配置后可用自然语言交互，例如：

"Search for ads on DealX with the query 'laptop'"
"Find the newest 5 ads for 'iPhone' on DealX"
"Search DealX for apartments in Kyiv"

适用场景

适用于需要让 LLM 访问 DealX 平台广告数据的场景，例如通过 LLM 搜索广告、集成到支持 MCP 的 LLM 应用（如 Claude Desktop、Cline）中。

限制

当前仅支持搜索广告，其他功能尚未实现。需要 Node.js v20+ 和 npm v11+。需要配置 DealX API URL。托管部署在 Fronteir AI 上可用。

扩展与贡献

服务器设计为易于扩展。添加新工具步骤：在 src/index.ts 的 TOOLS 对象中定义工具；在 src/tools 目录创建新文件实现工具逻辑；在 ListToolsRequestSchema 和 CallToolRequestSchema 处理器中添加工具；在 src/index.ts 中导入新工具。

故障排除

服务器启动失败：检查 Node.js 版本、依赖安装、.env 文件、控制台错误
LLM 无法连接：确保服务器运行、MCP 配置正确、可执行文件路径正确、环境变量设置正确
无法连接 DealX API：确保 API 运行、DEALX_API_URL 正确、API 端点可访问

如遇未覆盖问题，可在 GitHub 仓库提交 issue。

工具介绍

用途