How do I use nowcoder-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@nowcoder-mcp-server find me the top 10 most recent interview experiences from ByteDance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

nowcoder-mcp-server

by DevEverything01

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

🐮 Nowcoder MCP Server

MCP Node TypeScript License: MIT

让 AI 直接访问牛客网——搜索题目、浏览面经、获取题解，一切通过 Model Context Protocol。

✨ 功能一览

工具	描述
`nowcoder_search`	全站搜索（讨论、题目、职位）
`nowcoder_list_problems`	浏览 ACM/OJ 题库，支持难度筛选
`nowcoder_get_problem`	获取题目完整描述、示例、限制
`nowcoder_get_problem_solutions`	获取社区题解列表
`nowcoder_list_topic_problems`	浏览专题题库（面试 TOP101、SQL 篇等）
`nowcoder_get_discussion`	获取讨论帖 / 动态的完整内容
`nowcoder_get_hot_topics`	获取首页热门讨论
`nowcoder_browse_interview`	浏览面经，支持按公司筛选

Related MCP server: Baidu Search MCP Server

🚀 快速开始

前置条件

Node.js ≥ 18
系统已安装 Chromium 依赖（用于 Playwright）

安装

git clone https://github.com/yourname/nowcoder-mcp-server.git
cd nowcoder-mcp-server
npm install
npm run build

postinstall 脚本会自动下载 Playwright Chromium。

运行

Stdio 模式（默认，用于 Claude Desktop / Cursor 等本地客户端）：

npm start

HTTP 模式（用于远程部署）：

npm run start:http
# 默认监听 http://0.0.0.0:3000/mcp

🔌 接入你的 AI 工具

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "nowcoder": {
      "command": "node",
      "args": ["/path/to/nowcoder-mcp-server/dist/index.js"]
    }
  }
}

Cursor

编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "nowcoder": {
      "command": "node",
      "args": ["/path/to/nowcoder-mcp-server/dist/index.js"]
    }
  }
}

VS Code (GitHub Copilot)

编辑 .vscode/mcp.json：

{
  "servers": {
    "nowcoder": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/nowcoder-mcp-server/dist/index.js"]
    }
  }
}

远程 HTTP 连接

如果你已将服务部署到公网（参见部署指南），在支持 Streamable HTTP 的客户端中直接填入 URL：

{
  "mcpServers": {
    "nowcoder": {
      "url": "https://your-domain.com/mcp"
    }
  }
}

🛠 工具详细说明

所有工具均支持 response_format 参数（"markdown" 或 "json"，默认 "markdown"）。设为 "json" 时，列表类工具返回带分页元数据的结构化 JSON，详情类工具返回结构化对象。错误响应统一携带 isError: true 标记。

`nowcoder_search` — 全站搜索

在牛客网上搜索讨论帖、面经、编程题、职位等内容。

// 搜索 Java 面经
{ "query": "Java面经", "type": "discuss", "page": 1 }

// 搜索算法题，返回 JSON
{ "query": "二叉树", "type": "problem", "response_format": "json" }

参数	类型	必填	说明
`query`	string	是	搜索关键词
`type`	string	否	`"all"` / `"discuss"` / `"problem"` / `"job"`，默认 `"all"`
`page`	number	否	页码，默认 1
`response_format`	string	否	`"markdown"` / `"json"`，默认 `"markdown"`

`nowcoder_list_problems` — 浏览题库

列出 ACM/OJ 编程题目，返回 ID、标题、难度、通过率。

{ "difficulty": 3, "page": 1 }
{ "keyword": "二叉树", "response_format": "json" }

参数	类型	必填	说明
`keyword`	string	否	搜索关键词
`difficulty`	number	否	`0`(全部) `1`-`5`(星级)，默认 `0`
`page`	number	否	页码，默认 1
`response_format`	string	否	`"markdown"` / `"json"`

`nowcoder_get_problem` — 题目详情

获取完整的题目描述，包含输入输出格式、示例数据和时空限制。

{ "problemId": "1001" }
{ "problemId": "1001", "response_format": "json" }

参数	类型	必填	说明
`problemId`	string	是	题目 ID
`response_format`	string	否	`"markdown"` / `"json"`

`nowcoder_get_problem_solutions` — 题解列表

获取社区提交的题解，包含作者、标题、摘要、点赞数。

{ "problemId": "1001", "page": 1 }
{ "problemId": "1001", "response_format": "json" }

参数	类型	必填	说明
`problemId`	string	是	题目 ID
`page`	number	否	页码，默认 1
`response_format`	string	否	`"markdown"` / `"json"`

`nowcoder_list_topic_problems` — 专题题库

获取牛客网特定专题的题目列表。

{ "topicId": "295", "page": 1 }
{ "topicId": "199", "response_format": "json" }

参数	类型	必填	说明
`topicId`	string	是	专题 ID（见下表）
`page`	number	否	页码，默认 1
`response_format`	string	否	`"markdown"` / `"json"`

常用专题：

ID	专题名称
295	面试 TOP101
199	SQL 篇
196	面试高频题目
182	笔试大厂真题
383	算法学习篇
389	笔试模板必刷
260	前端篇

`nowcoder_get_discussion` — 讨论帖详情

获取讨论帖的完整内容，支持 Markdown 或结构化 JSON 输出。

{ "url": "353154004265934848" }
{ "url": "https://www.nowcoder.com/discuss/353154004265934848", "response_format": "json" }

参数	类型	必填	说明
`url`	string	是	完整 URL、discuss ID 或 feed UUID
`response_format`	string	否	`"markdown"` / `"json"`

`nowcoder_get_hot_topics` — 热门内容

无需参数，返回牛客网当前热门讨论和话题（最多 20 条）。

`nowcoder_browse_interview` — 浏览面经

浏览面试经验分享，支持按公司名称筛选。

{ "page": 1 }
{ "company": "字节跳动", "page": 1, "response_format": "json" }

参数	类型	必填	说明
`company`	string	否	公司名称筛选
`page`	number	否	页码，默认 1
`response_format`	string	否	`"markdown"` / `"json"`

JSON 响应格式

列表类工具在 response_format: "json" 时返回 PaginatedResult 结构：

{
  "items": [ ... ],
  "page": 1,
  "count": 10,
  "has_more": true
}

has_more 基于当前页是否有结果推断（爬虫场景无法获取精确总数）
详情类工具返回对应的结构化对象

⚙️ 环境变量

变量	默认值	说明
`TRANSPORT`	`stdio`	传输模式：`stdio` / `http` / `https`
`PORT`	`3000`	HTTP 模式监听端口
`HOST`	`0.0.0.0`	HTTP 模式监听地址（本地开发建议 `127.0.0.1`）
`ALLOWED_ORIGINS`	`*`	CORS 允许的来源，多个用逗号分隔
`SSL_CERT`	—	自定义 SSL 证书路径
`SSL_KEY`	—	自定义 SSL 私钥路径

🌐 部署到服务器

方案一：Caddy 反向代理（推荐）

最简单的公网部署方案，Caddy 自动管理 Let's Encrypt 证书：

# 1. 以 HTTP 模式启动 MCP 服务
TRANSPORT=http PORT=3001 node dist/index.js

# 2. 安装 Caddy 并配置反向代理
apt install caddy
cat > /etc/caddy/Caddyfile << EOF
your-domain.com {
    reverse_proxy localhost:3001
}
EOF
systemctl restart caddy

MCP 地址：https://your-domain.com/mcp

没有域名？ 可以使用 your-ip.sslip.io 作为免费域名，Caddy 同样能自动获取证书。

方案二：Systemd 服务

cp deploy/nowcoder-mcp.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now nowcoder-mcp

方案三：ngrok 内网穿透

# 启动 HTTP 模式
TRANSPORT=http node dist/index.js &

# 使用 ngrok 暴露
ngrok http 3000

MCP 地址：https://xxxx.ngrok-free.app/mcp

🏗 项目结构

src/
├── index.ts              # 入口，Stdio / HTTP / HTTPS 传输
├── constants.ts          # 配置常量
├── types.ts              # TypeScript 类型定义
├── schemas/
│   └── index.ts          # Zod 输入校验
├── services/
│   ├── browser.ts        # Playwright 浏览器管理（连接池、重试、反检测）
│   └── scraper.ts        # 页面解析工具（HTML→Markdown、截断）
└── tools/
    ├── search.ts         # 全站搜索
    ├── problems.ts       # 题库相关（列表、详情、题解、专题）
    ├── discussions.ts    # 讨论帖 & 热门内容
    └── interview.ts      # 面经浏览

🔧 开发

# 开发模式（热重载）
npm run dev

# HTTP 模式开发
npm run dev:http

# 构建
npm run build

# 清理
npm run clean

技术要点

MCP 规范合规：错误响应携带 isError: true，列表工具返回分页元数据（PaginatedResult），支持 response_format 双格式输出
无状态 HTTP：每个请求独立处理，不维护服务端会话，适合水平扩展和无状态部署
Playwright + Stealth 插件：使用 playwright-extra 搭配反检测插件，规避网站的爬虫检测
智能重试：对超时、网络错误、限流自动指数退避重试（最多 3 次）
资源优化：拦截图片、字体、样式表等非必要资源，加速页面加载
CORS 安全：通过 ALLOWED_ORIGINS 环境变量配置允许的跨域来源，默认 *
内容安全：25,000 字符自动截断，防止上下文窗口溢出

📄 License

MIT

免责声明：本项目仅供学习和研究使用。请遵守牛客网的使用条款，合理使用，避免高频请求对其服务造成影响。

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DevEverything01/newcoder-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server