nwafu-mcp · 西北農林科技大学キャンパス情報 MCP ツール集

任意のエージェントプラットフォームにデプロイされた Agent 向けに、MCP プロトコル に準拠したツール群を提供します。以下3つの中核機能をカバーしています：

1. キャンパスチャンネル人気まとめ：西北農林科技大学公式 QQ チャンネル（pd.qq.com/g/inwafu1934）の直近の人気投稿を取得し、インタラクション数でソートして「イベント / コンテスト / お知らせ / おすすめ / ヒント / 相談」などのカテゴリに自動分類します。重要な情報にはすべて元投稿のタイトルとリンクを添付し、トレーサビリティを保証します。

2. 公式サイトクイック検索：学校公式サイト（www.nwafu.edu.cn）とニュースサイトの全文インデックスを通じて、最近のイベント、コンテスト、お知らせ、採用情報をすばやく検索します。「植保学院」「教务处」などのキーワードを渡すことで検索範囲を絞り込めます。

3. サイト横断カスタム検索：ユーザーの質問を自動的に検索語へ分割し、公式サイトの全文インデックスとキャンパスチャンネルの直近投稿の両方を検索して統合出力します。すべての結果を読みやすい Markdown に整形し、原文リンクを添付します。

機能特長

• MCP 標準実装：公式 mcp Python SDK（FastMCP）ベース、stdio 転送。Claude Desktop、Cursor、Windsurf、および MCP をサポートする各種エージェントプラットフォームに直接接続できます。

• 情報のトレーサビリティ：すべての結論項目には出典タイトル＋原文リンクを添付し、重要な情報は「重要なお知らせ / タイムリーネス情報」ブロックとして個別に表示します。

• スマート分類：ルールエンジンがチャンネル投稿を「おすすめ / ヒント / イベント / コンテスト / お知らせ / 相談」などのカテゴリに自動分類し、グループ内では人気度（いいね + コメントの重み付け）順にソートします。

• キーワード精密検索：公式サイト検索では任意のキーワード（学部名、部門名、事項名など）で範囲を絞り込めます。

• 堅牢なフォールトトレランス：リクエストタイムアウト、リトライ、レート制限用のランダム遅延、Cookie 期限切れの通知に対応。単一ツールの障害が他のツールに影響しません。

• プライバシーとコンプライアンス：公開されているコンテンツのみを取得し、ログイン・権限チェックを回避しません。Cookie は環境変数で注入され、コードリポジトリには書き込みません。

Related MCP server: NanoSearchMCP

ツール一覧

すべてのツールの出力は Markdown テキストで、構成は：データソース、取得時刻、検索条件、 結果リスト（タイトル / 日付 / 出典 / 概要 / リンク）、重要なお知らせです。

動作原理

キャンパス QQ チャンネル

テンセントチャンネルの Web 版はフロントエンドのみでレンダリングされ、公開データは protobuf-over-JSON ゲートウェイから取得されます：

POST https://pd.qq.com/qunng/guild/gotrpc/noauth/trpc.qchannel.commreader.ComReader/<Method>
x-oidb: {"uint32_service_type": 11 时间线 | 5 评论}

匿名でも公開コンテンツは読み取れますが、ゲートウェイはブラウザレベルのセッション Cookie（p_uin + uuid + EO-Bot-Js-Token）を要求します。本ツールでは：

• デフォルトで「投稿広場」サブフォーラム（670126629）の直近 N 件の投稿を取得（公開時刻順）

• 点赞数 + 2 × 评论数 で人気度を推定し、時間窓内で最も人気のある投稿を抽出

• ルールエンジンで自動分類し、重要な情報（お知らせ/公告/申込/締切/試験など）は個別に提示

• オプションで人気ランキングの投稿のホットコメントを取得（GetFeedComments）

補足：GetGuildFeeds の「人気順」インターフェースは実測で空データを返すため、人気ランキングは「直近の投稿 × インタラクション数」方式を採用しています。これは「直近の人気」の意味合いに合致します。

学校公式サイト

学校メインサイトとニュースサイトは通元 CMS の全文検索を使用しています：

GET https://www.nwsuaf.edu.cn/cms/web/search/index.jsp
    ?query=<关键词>&siteID=<站点ID>&searchScope=0&channelID=&matchType=0
    &sortField=publishDate&order=1&date=<3|6|12>&page=<页码>

• siteID=32e6d9be... はメインサイトのインデックス（全学の各学部・部門をカバー）

• カテゴリごとに検索語を生成（お知らせ/公告、イベント/講演/フォーラム、コンテスト/大会、採用など）。ユーザーのキーワードと統合してページング取得し、タイトル、日付、出典、概要、原文リンクを解析

• 期間はデフォルトで直近 90 日（インデックスの 3/6/12 か月フィルターにマッピング）

クイックスタート（ローカル実行）

cd nwafu-mcp
uv sync --extra dev

1. チャンネル Cookie の設定（任意。チャンネル系ツールのみ必要）

uv run nwafu-export-cookies --out cookies.json

スクリプトはローカルの Edge/Chrome でチャンネルページを開いてセッションを確立し、Cookie をエクスポートします。その後、 cookies.json 内の cookie_header を環境変数に設定します：

$env:PDQQ_COOKIES = "p_uin=xxx; uuid=xxx; EO-Bot-Js-Token=xxx"
# 或
$env:NWAFU_COOKIE_FILE = "F:\path\to\cookies.json"

Cookie は期限切れになります（アンチスクレイピング token がブラウザインスタンスに紐づいているため）。クラウドデプロイでは定期的な更新を推奨します。

2. ツール関数の直接テスト（MCP クライアントを経由しない）

uv run python -c "
import os
os.environ['NWAFU_COOKIE_FILE'] = 'cookies.json'
from nwafu_mcp.server import official_site_recent
print(official_site_recent(category='通知', keyword='植保学院'))
"

3. MCP Server として実行

uv run nwafu-mcp

MCP クライアントへの接続

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "nwafu-campus": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/unielevotor/nwafu-AgentPlatformMCP",
        "nwafu-mcp"
      ],
      "env": {
        "PDQQ_COOKIES": "p_uin=xxx; uuid=xxx; EO-Bot-Js-Token=xxx"
      }
    }
  }
}

Cursor / Windsurf / 汎用プラットフォーム（JSON 形式）

{
  "mcpServers": {
    "nwafu-campus": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/unielevotor/nwafu-AgentPlatformMCP", "nwafu-mcp"],
      "env": {
        "PDQQ_COOKIES": "p_uin=xxx; uuid=xxx; EO-Bot-Js-Token=xxx",
        "PDQQ_GUILD_ID": "inwafu1934",
        "PDQQ_CHANNEL_ID": "670126629"
      }
    }
  }
}

または、pip install git+https://github.com/unielevotor/nwafu-AgentPlatformMCP でインストール後、nwafu-mcp コマンドで直接起動することもできます。

GitHub デプロイ手順

1. GitHub リポジトリ（unielevotor/nwafu-AgentPlatformMCP）にプッシュ：

git remote add origin https://github.com/unielevotor/nwafu-AgentPlatformMCP.git
git push -u origin main

2. リポジトリが Public であることを確認（プライベートリポジトリの場合、対象のエージェントプラットフォームが GitHub の認証情報にアクセスできる必要があります）。

3. エージェントプラットフォームの MCP 設定に上記の uvx --from git+... 起動コマンドを入力し、PDQQ_COOKIES などの環境変数を注入します。

環境変数

参考：.env.example。

出力例（抜粋）

# 🎓 西农校园频道 · 近期热门总结

> 数据来源：西北农林科技大学官方 QQ 频道 ｜ 时间窗口：近 72 小时 ｜ 帖子数：48

## 🔥 热度榜
1. **中元节鬼是真的多啊…**（👍7 · 💬1 · 08-27）
   来源：[中元节鬼是真的多啊](https://pd.qq.com/g/inwafu1934/post/...)

## 🏆 竞赛（2）
- **关于举办2026年创新创业大赛的通知**（👍5 · 💬2 · 08-26）
  来源：[…](https://pd.qq.com/g/inwafu1934/post/...)

## ⚠️ 重点信息（建议优先查看）
- [关于选课时间安排的通知](https://pd.qq.com/g/inwafu1934/post/...)

# 📢 西北农林科技大学官网 · 近期信息查询

> 查询条件：分类=通知 ｜ 关键词=植保学院 ｜ 时间范围：近 90 天 ｜ 结果数：12

1. **关于举办2026年植保论坛系列学术报告会（十七）的通知**（2026-08-26 · 植物保护学院）
   [查看原文](https://ppc.nwafu.edu.cn/xzbg/...)

コンプライアンスと利用上の推奨事項

• 取得対象は公開されているコンテンツのみとし、ログイン、有料、権限チェックを回避しません。

• ランダム UA、ランダム遅延、失敗時のリトライを内蔵済みです。デプロイ時は遅延を短縮して高頻度で取得しないでください。対象プラットフォームの利用規約と「個人情報保護法」などの適用法令を遵守してください。

• 重要な情報（申込締切、試験日程など）は公式の原文を基準とし、本ツールの出力は概要確認用です。

• チャンネル Cookie にはセッション識別子が含まれます。公開リポジトリにコミットせず、必ず環境変数で注入してください。

よくある質問

ディレクトリ構成

src/nwafu_mcp/
  server.py          MCP 服务器与四个工具定义
  qq_channel.py      QQ 频道数据层（时间线/热评）
  official_site.py   官网全文检索数据层
  classify.py        帖子分类与热度评分
  format.py          Markdown 报告排版
  config.py          环境变量与默认配置
  export_cookies.py  本地导出频道 Cookie 的 CLI
tests/               单元测试
scripts/mcp_smoke.py 端到端 MCP 冒烟测试（连接 stdio server 并调用全部工具）