newcoder-mcp-server

MCP搜索检索

提供方 DevEverything01

搜索检索 Streamable HTTP 未标注 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

This is a Model Context Protocol service that enables AI assistants to access Nowcoder directly, supporting site-wide search, ACM/OJ problem browsing, problem details and community solutions, hot discussions, and interview experience lookup for coding practice, job preparation, and AI-assisted programming.

一句话选型结论

按资料字段整理

newcoder-mcp-server 属于搜索检索类 MCP 服务器,Streamable HTTP,鉴权方式未标注,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式Streamable HTTP 鉴权未标注 部署方式远程部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Blend Deployment MCP Server Nowcoder TypeScript AI Assistant Integration Programming Problems Interview Experience Solution Lookup Site Search Developer Tool

支持客户端

适用场景

Blend DeploymentMCP ServerNowcoder

安装与配置

Streamable HTTP 未标注
新一代远程传输,替代 SSE
node /path/to/nowcoder-mcp-server/dist/index.js

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
newcoder-mcp-server当前 未标注 Streamable HTTP 远程部署 有 2026-03-03
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方DevEverything01上游标注的维护方 DevEverything01
分类搜索检索本站按上游分类展示
连接方式Streamable HTTP新一代远程传输,替代 SSE
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · node本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-03-03上游最后核验时间

详细介绍

9.6 KB
来自项目仓库与上游目录的原文,未做删改

🐮 Nowcoder MCP Server

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

⟷

MCP
⟷
🤖 AI


✨ 功能一览

工具 描述
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 浏览面经,支持按公司筛选

🚀 快速开始

前置条件

  • Node.js ≥ 18
  • 系统已安装 Chromium 依赖(用于 Playwright)

安装```bash

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 等本地客户端):```bash
npm start

HTTP 模式(用于远程部署):```bash
npm run start:http

默认监听 http://0.0.0.0:3000/mcp


## 🔌 接入你的 AI 工具

### Claude Desktop

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:```json
{
  "mcpServers": {
    "nowcoder": {
      "command": "node",
      "args": ["/path/to/nowcoder-mcp-server/dist/index.js"]
    }
  }
}

Cursor

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


### VS Code (GitHub Copilot)

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

远程 HTTP 连接

如果你已将服务部署到公网(参见部署指南),在支持 Streamable HTTP 的客户端中直接填入 URL:```json
{
"mcpServers": {
"nowcoder": {
"url": "https://your-domain.com/mcp"
}
}
}


## 🛠 工具详细说明

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

### `nowcoder_search` — 全站搜索

在牛客网上搜索讨论帖、面经、编程题、职位等内容。```jsonc
// 搜索 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、标题、难度、通过率。```jsonc
{ "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` — 题目详情

获取完整的题目描述,包含输入输出格式、示例数据和时空限制。```jsonc
{ "problemId": "1001" }
{ "problemId": "1001", "response_format": "json" }
参数 类型 必填 说明
problemId string 是 题目 ID
response_format string 否 "markdown" / "json"

nowcoder_get_problem_solutions — 题解列表

获取社区提交的题解,包含作者、标题、摘要、点赞数。```jsonc
{ "problemId": "1001", "page": 1 }
{ "problemId": "1001", "response_format": "json" }


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

### `nowcoder_list_topic_problems` — 专题题库

获取牛客网特定专题的题目列表。```jsonc
{ "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 输出。```jsonc
{ "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` — 浏览面经

浏览面试经验分享,支持按公司名称筛选。```jsonc
{ "page": 1 }
{ "company": "字节跳动", "page": 1, "response_format": "json" }
参数 类型 必填 说明
company string 否 公司名称筛选
page number 否 页码,默认 1
response_format string 否 "markdown" / "json"

JSON 响应格式

列表类工具在 response_format: "json" 时返回 PaginatedResult 结构:```json
{
"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 证书:```bash
# 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 服务```bash

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


### 方案三:ngrok 内网穿透```bash
# 启动 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 # 面经浏览


## 🔧 开发```bash
# 开发模式(热重载)
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


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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
newcoder-mcp-server 怎么安装?

在客户端按下面的安装命令接入:node /path/to/nowcoder-mcp-server/dist/index.js。装完在客户端配置里引用同一个包或端点。

newcoder-mcp-server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是Streamable HTTP,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

newcoder-mcp-server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

newcoder-mcp-server 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

newcoder-mcp-server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

newcoder-mcp-server 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、MCP Server、Nowcoder、TypeScript、AI Assistant Integration、Programming Problems。具体工具清单以官方文档为准。

newcoder-mcp-server 需要什么运行环境?

运行时为 node;属于远程端点,不需要在本地装运行时。

newcoder-mcp-server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为Streamable HTTP。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-03-03。