@dealx/mcp-server

@dealx/mcp-server

site icon
2025.04.02 0
TypeScript广告搜索平台交互其它
mcp-server 是一个为 DealX 平台设计的 Model Context Protocol (MCP) 服务器,允许大型语言模型(LLMs)与 DealX 平台进行交互,特别是用于搜索广告。它实现了 MCP 规范,为 LLMs 提供了一个标准化的接口来访问数据和执行操作。
View on GitHub

Overview

基本能力

产品定位

mcp-server 是一个为 DealX 平台设计的 Model Context Protocol (MCP) 服务器,允许大型语言模型(LLMs)与 DealX 平台进行交互,特别是用于搜索广告。

核心功能

  • 实现 MCP 规范,为 LLMs 提供标准化接口
  • 支持搜索广告功能
  • 可扩展性:支持添加新工具
  • 开发友好:提供详细的开发文档和脚本

适用场景

  • LLMs 需要与 DealX 平台交互的场景
  • 自动化搜索广告
  • 开发扩展功能以增强 DealX 平台的交互能力

工具列表

  • search_ads: 搜索 DealX 平台上的广告
  • 参数: query (搜索字符串), sort (排序方式), offset (分页偏移), limit (结果数量)
  • 示例: {"query": "laptop", "sort": "-created", "offset": 1, "limit": 10}

常见问题解答

  • 服务器无法启动: 检查 Node.js 版本、依赖、.env 文件和错误信息
  • 连接问题: 确认服务器运行状态、MCP 配置和路径正确性
  • API 连接问题: 检查 DealX API 运行状态和 DEALX_API_URL 设置

使用教程

使用依赖

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

安装教程

  1. 通过 npm 全局安装: shell npm install -g @dealx/mcp-server
  2. 开发安装: shell git clone <repository-url> cd dealx/mcp npm install cp .env.example .env npm run build

调试方式

  1. 启动服务器: shell node node_modules/@dealx/mcp-server/build/index.jsshell npx -y @dealx/mcp-server
  2. 使用环境变量: shell DEALX_API_URL=https://dealx.com.ua npx -y @dealx/mcp-server
  3. 开发模式: shell npm start

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。