NGA MCP Server

基于 MCP (Model Context Protocol) 的 NGA 论坛浏览服务器，允许 AI 助手（如 Claude）直接浏览和搜索 NGA 论坛的帖子。

功能

Related MCP server: Tapatalk MCP Server

环境要求

• Python ≥ 3.10

快速开始

1. 安装依赖

pip install -e ".[dev]"

2. 启动服务

Windows： 双击运行 start.bat，或在命令行中执行：

python src/nga_server.py

Linux / macOS：

chmod +x start.sh
./start.sh

服务默认运行在 http://0.0.0.0:8001，MCP 端点为 /mcp。

3. 配置环境变量（可选）

MCP 客户端配置

在 MCP 客户端的配置文件中添加：

{
  "mcpServers": {
    "nga-bbs": {
      "url": "http://localhost:8001/mcp"
    }
  }
}

• Claude Desktop: 编辑 claude_desktop_config.json

• Claude Code / VS Code 插件: 编辑项目或用户级的 mcp.json

工具详情

browse_forum — 浏览版块

browse_post — 浏览帖子

search_post — 搜索帖子

项目结构

nga_mcp/
├── src/
│   └── nga_server.py    # MCP 服务入口
├── pyproject.toml        # 项目配置与依赖
├── start.bat             # Windows 启动脚本
├── start.sh              # Linux/macOS 启动脚本
└── README.md

常见问题

端口被占用

修改环境变量 NGA_MCP_PORT 更换端口，并相应更新 MCP 客户端配置中的 URL。

被反爬拦截

NGA 对高频请求有限流和反爬机制。如遇到 429 或 guestJs 拦截，请稍等片刻再试。

页面编码

NGA WAP 页面使用 GBK 编码，服务端会自动处理解码。

技术栈

• MCP Python SDK — Streamable HTTP 传输

• httpx — 异步 HTTP 客户端

• BeautifulSoup4 + lxml — HTML 解析

• uvicorn — ASGI HTTP 服务器

License

MIT