V2ex

Description

mcp-server-v2ex is an MCP server that wraps the V2EX API 2.0 for MCP-compatible agents and developer tools. It exposes structured operations for notifications, token management, member profile lookup, node browsing, topic retrieval, comment retrieval, and daily hot-topic summaries.

The project is designed as a reusable integration layer for general-purpose agents rather than a client-specific plugin, so it can be connected to Claude Desktop, Codex, and other tools that support the Model Context Protocol.

For Chinese documentation, see README.zh-CN.md.

Available tools

• notifications: Fetch the latest notifications
• delete_notifications: Delete selected notifications
• member_profile: Get the profile of the user associated with the API token
• token: Inspect the current API token
• create_token: Create a new API token
• nodes: Get node information
• node_topics: List topics under a specific node
• topic_detail: Get the content of a topic
• topic_comments: Get replies for a topic
• daily_summary: Generate a summary of recent hot topics

Installation

Install the package from npm:

npm install -g mcp-server-v2ex

Configuration

First, create or retrieve a V2EX API token from V2EX token settings.

Example MCP client configuration:

{
  "v2ex": {
    "command": "%APP_DATA%\\Local\\nvm\\v22.14.0\\node.exe",
    "args": [
      "%APP_DATA%\\Local\\nvm\\v22.14.0\\node_modules\\mcp-server-v2ex\\dist\\index.js"
    ],
    "env": {
      "V2EX_API_KEY": "your-token-here",
      "NODE_TLS_REJECT_UNAUTHORIZED": "0"
    }
  }
}

NODE_TLS_REJECT_UNAUTHORIZED=0 is only useful in special local networking setups, such as MITM proxy tooling. Do not enable it unless you understand the security tradeoff.

Changelog

• v0.1.1 / 2025-04-02
  • Added daily hot-topic summaries
  • 
• v0.1.0
  • Initial feature-complete release

Roadmap

• Improve daily hot-topic summarization for agent-driven workflows
• Expand documentation for broader MCP client integrations