🗣️ Debate Helper MCP Server - 抬杠助手

让 AI 助手变身抬杠达人，无论你说什么都会反驳！

基于 MCP(Model Context Protocol) 协议打造的抬杠助手服务器，让 AI 助手能够以"你说的不对"的方式回应所有输入。

✨ 功能特性

该 MCP 服务器提供一个简单的抬杠工具：

🎲 抬杠助手 - 无论用户说什么，都会固定回复"你说的不对"

🚀 快速上手

📋 先决条件

• Node.js 16.0.0+ 🟢
• npm 或 yarn 📦

💻 安装步骤

方式一：通过 npx 快速安装（推荐）⭐

无需手动克隆和构建，直接使用 npx 运行：

npx debate-helper-mcp

使用自定义端口：

npx debate-helper-mcp --port 8080

方式二：从源码安装

1. 克隆仓库

git clone https://github.com/worryzyy/debate-helper-mcp.git
cd debate-helper-mcp

2. 安装依赖

npm install

3. 编译代码

npm run build

🎯 命令行参数

服务器支持以下命令行参数：

• --transport <type> - 传输模式：stdio 或 http（默认为 stdio）
• --port <number> - HTTP 服务监听端口（默认为 3000，仅 HTTP 模式使用）

示例：

# STDIO 模式（默认，适用于 MCP 客户端）
node build/index.js

# HTTP 模式，使用 8080 端口
node build/index.js --transport http --port 8080

# 使用 npx 运行 HTTP 模式
npx debate-helper-mcp --transport http --port 8080

🍽️ 开始使用

🔥 启动服务器

STDIO 模式（推荐用于 MCP 客户端）

npm start
# 或
npm run dev

服务器将以 STDIO 模式启动，通过标准输入/输出与 MCP 客户端通信。

HTTP 模式

npm start -- --transport http

服务器将在 http://localhost:3000 启动，提供以下端点：

• /mcp - MCP 协议端点
• /health - 健康检查
• /info - 服务器信息

🔧 配置 MCP 客户端

MCP 客户端默认使用 STDIO 传输模式，这是最简单和推荐的配置方式。

使用 Cursor

在 Cursor 设置中添加 MCP 服务器配置（通常在 .cursor/config.json 或设置界面）：

方式一：使用 npx（推荐）⭐

{
  "mcpServers": {
    "debate-helper": {
      "command": "npx",
      "args": ["debate-helper-mcp"]
    }
  }
}

方式二：使用本地安装

{
  "mcpServers": {
    "debate-helper": {
      "command": "node",
      "args": ["/path/to/debate-helper-mcp/build/index.js"]
    }
  }
}

使用 Claude Desktop

在 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

使用 npx（推荐）：

{
  "mcpServers": {
    "debate-helper": {
      "command": "npx",
      "args": ["debate-helper-mcp"]
    }
  }
}

使用本地路径：

{
  "mcpServers": {
    "debate-helper": {
      "command": "node",
      "args": ["/absolute/path/to/debate-helper-mcp/build/index.js"]
    }
  }
}

其他 MCP 客户端

对于其他支持 MCP 协议的客户端（如 Zed, VSCode 等），请参考各自的文档进行配置。

标准 STDIO 配置：

• 传输模式: STDIO（默认）
• 命令: npx 或 node
• 参数: ["debate-helper-mcp"] 或 ["/path/to/build/index.js"]

HTTP 模式配置（如需要）：

某些客户端可能需要 HTTP 模式，添加 --transport http 参数：

{
  "mcpServers": {
    "debate-helper": {
      "command": "npx",
      "args": ["debate-helper-mcp", "--transport", "http", "--port", "3000"]
    }
  }
}

重启客户端，让配置生效 ✨

🧙‍♂️ 使用指南

在 MCP 客户端中使用示例：

用户：天气真好
AI：（调用抬杠工具）你说的不对

用户：今天吃什么？
AI：（调用抬杠工具）你说的不对

用户：1+1=2
AI：（调用抬杠工具）你说的不对

📝 开发命令

npm run build                          # 编译 TypeScript 代码
npm start                              # 启动服务器（STDIO 模式）
npm run dev                            # 开发模式（自动编译并启动 STDIO 模式）
npm start -- --transport http          # 启动 HTTP 模式服务器
npm run dev -- --transport http        # 开发模式（HTTP 模式）

🔄 传输模式说明

STDIO 模式（默认）

• 使用场景: MCP 客户端（Cursor、Claude Desktop 等）
• 通信方式: 通过标准输入/输出流进行 JSON-RPC 通信
• 优点:
  • 配置简单，无需网络端口
  • 更安全，不暴露网络接口
  • 标准 MCP 推荐方式
• 启动: npm start 或 node build/index.js

HTTP 模式

• 使用场景: Web 应用、API 调用、调试测试
• 通信方式: HTTP/HTTPS REST API
• 优点:
  • 可通过网络访问
  • 支持多客户端并发
  • 便于调试和测试
• 启动: npm start -- --transport http
• 端点:
  • /mcp - MCP 协议主端点
  • /health - 健康检查
  • /info - 服务器信息

🔌 支持的 MCP 客户端

本服务器适用于所有支持 MCP 协议的 AI 助手和客户端，包括但不限于：

• 🤖 Claude 桌面应用
• 📝 Cursor
• 💼 其他支持 MCP 的客户端

🤝 贡献

欢迎 Fork 和 Pull Request！

📄 许可

ISC License

🗣️ 准备好体验纯粹的抬杠艺术了吗？