mcp-for-nwafactivity · 西北农林科技大学校园信息 MCP 工具集

一套符合 MCP 协议 的智能体工具集，为部署在 任意智能体平台上的 Agent 提供西农校园信息能力：

1. 校园频道热门总结：总结西北农林科技大学官方 QQ 频道 （pd.qq.com/g/inwafu1934）近期热门帖子， 自动归类为「活动 / 竞赛 / 通知 / 推荐 / 贴士 / 求助」等，重要信息附来源标题与链接。
2. 官网快速查询：查询学校官网（www.nwafu.edu.cn） 最近的通知、活动、竞赛、招聘，支持输入「植保学院」「教务处」等关键词缩小范围。
3. 跨站自定义检索：自动拆解问题关键词，在官网全文索引与校园频道近期帖子中 检索并合并输出，排版为易读的 Markdown。

工具列表

快速开始（本地）

cd nwafu-mcp
uv sync --extra dev --extra cookies
uv run mcp-for-nwafactivity

频道类工具需要 QQ 频道会话 Cookie（p_uin / uuid / EO-Bot-Js-Token）， 首次使用请先导出并配置：

uv run nwafu-export-cookies --out cookies.json
$env:NWAFU_COOKIE_FILE = "F:\path\to\cookies.json"
# 或把 cookies.json 中的 cookie_header 填入环境变量 PDQQ_COOKIES

不想手动维护 Cookie？见下文「Cookie 自动化」。

部署到魔搭社区（可托管部署）

项目已发布到 PyPI。魔搭 STDIO 托管只支持 npx / uvx，且只能拉取已发布包， 因此服务配置如下：

{
  "mcpServers": {
    "nwafu-campus": {
      "command": "uvx",
      "args": ["mcp-for-nwafactivity"],
      "env": {
        "PDQQ_COOKIES": "p_uin=xxx; uuid=xxx; EO-Bot-Js-Token=xxx",
        "PDQQ_GUILD_ID": "inwafu1934",
        "PDQQ_CHANNEL_ID": "670126629"
      }
    }
  }
}

创建步骤：

1. 打开 创建 MCP 服务，保持 「从 GitHub 仓库快速创建」。
2. GitHub 地址填 https://github.com/unielevotor/nwafu-AgentPlatformMCP， 英文名称填 nwafu-campus，托管类型选「可托管部署」。
3. 平台自动解析本 README 的服务配置并执行部署检测 （uvx 安装包 → 连接 → list_tools），通过后即可在工具页测试使用。

同一份配置也可直接用于 Claude Desktop / Cursor 等本地客户端。 PDQQ_COOKIES 过期后重新导出并在连接时更新；官网类工具无需 Cookie。

如需以远程 HTTP 方式部署（Docker / Serverless），用 mcp-for-nwafactivity --transport streamable-http 启动，详见代码内 --help 与仓库 Dockerfile。

Cookie 自动化（无需手动填 PDQQ_COOKIES）

QQ 频道会话 Cookie 会过期，手动复制容易忘。项目提供两个自动化手段：

1. 本地 Cookie 守护程序 nwafu-cookie-keeper：周期性用浏览器自动刷新 Cookie 并写入 cookies.json，可附带启动 HTTP 端点供 MCP 拉取：

   uv run nwafu-cookie-keeper --serve 127.0.0.1:8765 --token 换成随机长令牌 --out cookies.json
   

2. MCP server 自动拉取：在 MCP 环境里配置 PDQQ_COOKIE_URL 指向上面端点的 /cookie，server 会按 TTL 自动拉取并缓存，无需手工填写：

   PDQQ_COOKIE_URL=http://127.0.0.1:8765/cookie
   PDQQ_COOKIE_TOKEN=换成随机长令牌
   PDQQ_COOKIE_REFRESH_TTL=600
   

本地 / 局域网部署时 keeper 与 MCP 同机即可；若 MCP 部署在魔搭云端，需要把 keeper 端点通过内网穿透（如 Cloudflare Tunnel）暴露为公网 HTTPS 地址。

环境变量

参考 .env.example。

合规说明

仅抓取公开可见内容，不绕过登录 / 权限校验；内置随机 UA、限速与重试，请勿调低 延迟做高频抓取。重要信息请以官方原文为准。