使用说明
mcp服务器qiita研究员
不仅仅是API包装，而是调查助手。
⚡ 3秒钟开始
只需将其粘贴到Claude Desktop配置文件中：
{
"mcpServers": {
"qiita-researcher": {
"command": "npx",
"args": ["-y", "mcp-server-qiita-researcher"],
"env": {
"QIITA_ACCESS_TOKEN": ""
}
}
}
}
重新启动Claude Desktop → 完了🎉
📁 設定ファイルの場所を確認する
克劳德桌面：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
如果文件不存在，请新建。
🔑 Qiitaアクセストークンを設定する（オプションだが推奨）
无标记： 60请求/小时 有标记： 1000请求/小时
- Qiita令牌设置访问
- 使用读取权限创建新标记
- 标记为
QIITA_ACCESS_TOKEN粘贴到
为什么这个MCP服务器？
大多数Qiita MCP服务器只是Qiita API的薄包装器。 mcp服务器qiita研究员在三个创新功能上实现差异化。
🎯 智能阅读：文章+有益评论
杀手功能 -通过一次调用获得最有价值的评论（反应数顺序TOP3），而不仅仅是文章
- 通过并行API调用加快速度
- 自动收集社区的见解和洞察力
- 用于令牌效率化的HTML清理
📈 趋势星探：一键发现趋势
在没有复杂查询语法或日期计算的情况下发现Qiita趋势文章
weekly：过去7天，20股以上monthly：过去30天，50股以上new_arrival：过去2天，5股以上- 可选主题缩小
🔍 降噪：查找质量重点
自动排除默认的低质量文章（可设置库存数量阈值）
- 自动查询
stocks:>N添加筛选器 - 删除令牌负载高的HTML（iframe、图像、脚本）
- 在段落边界处智能填充
与其他Qiita MCP服务器比较
功能｜本服务器｜其他｜ |------|-----------|-----| | 文章+评论同时获取 | ✅ 并行获取❌ 仅文章 | 自动质量筛选 | ✅ 库存阈值｜❌ 没有 | 趋势自动计算 | ✅ 点击一次❌ 手动查询 | HTML清理 | ✅ cheerio | ❌ 没有 | 日语错误信息 | ✅ 完全对应⚠️ 仅限英语 | 型安全性 | ✅ TypeScript + Zod | ⚠️ 部分的 |
使用方法
只是自然地和Claude搭话：
💬 “请用Qiita告诉我‘TypeScript’的流行报道”
→ get_tech_trends 自动收集周趋势
💬 “请搜索‘React hooks’”
→ search_articles 仅过滤高质量文章
💬 “总结这篇Qiita文章：https://qiita.com/.../items/abc123」
→ read_article_smart 获取文章+有用的注释
🖥️ Claude Code CLIで使う場合
配置文件
~/.claude.json 编辑：
{
"mcpServers": {
"qiita-researcher": {
"command": "npx",
"args": ["-y", "mcp-server-qiita-researcher"],
"env": {
"QIITA_ACCESS_TOKEN": ""
}
}
}
}
起动
claude
尝试Claude：
Qiitaで「React」のトレンドを教えて
✅ 三个工具（search_articles、get_tech_trends、read_article_smart）来使用
🔧 開発者向けセットアップ（ソースコードからビルド）
想要修改、定制代码时：
克隆和构建
git clone https://github.com/yourusername/mcp-server-qiita-researcher.git
cd mcp-server-qiita-researcher
npm install
npm run build
配置文件
npx代替node使用：
{
"mcpServers": {
"qiita-researcher": {
"command": "node",
"args": ["/絶対パス/mcp-server-qiita-researcher/build/index.js"],
"env": {
"QIITA_ACCESS_TOKEN": ""
}
}
}
}
确认绝对路径：
cd mcp-server-qiita-researcher
pwd
开发指令
npm run dev # ウォッチモード（変更を自動検知）
npm run build # ビルド
npm start # 起動確認
项目结构
src/
├── index.ts # MCPサーバーエントリーポイント
├── qiitaClient.ts # Qiita APIクライアント
├── types.ts # Zodスキーマ + TypeScript型
├── constants.ts # 設定
└── utils/
├── dateUtils.ts # 日付計算
├── queryBuilder.ts # クエリ構築
├── htmlCleaner.ts # HTMLクリーンアップ（cheerio）
└── textTruncator.ts # スマート切り詰め
📚 API リファレンス
search_articles -查找注重质量
{
"query": "React hooks", // 検索キーワード
"sort": "stock", // "rel" (関連度順) | "stock" (ストック数順)
"threshold_stocks": 20 // 最小ストック数（デフォルト: 10）
}
动作：
- 低质量记事を自动除外
- 返回标记高效的干净摘要
get_tech_trends -趋势发现
{
"scope": "weekly", // "weekly" | "monthly" | "new_arrival"
"topic": "React" // オプション：タグで絞り込み
}
动作：
- 自动计算日期范围
- 应用适当的库存阈值
- 在没有复杂查询语法的情况下获取趋势文章
read_article_smart ⭐ - 文章+注释批量获取
{
"item_id": "abc123def456" // URLの末尾ID
}
杀手功能：
- 文章正文+反应数TOP3并列取得评论
- 提供仅靠报道无法获得的社区知识
- 超过20000个字符时的智能切口
取得内容:
- 文章元数据（标题、作者、制作日期、库存数、赞数、标签）
- 干净的文章正文（已删除HTML）
- 按反应数排序的前3个注释
🔍 トラブルシューティング
无法识别工具
npx版
# 動作確認
npx -y mcp-server-qiita-researcher
# キャッシュクリア
npm cache clean --force
预期输出：
Qiita Researcher MCP Server started successfully
Version: 1.0.0
源代码版本
# ビルド確認
npm run build
ls build/index.js
# パス確認
pwd # この出力が設定ファイルのパスと一致するか確認
→ 完全重新启动Claude（关闭所有窗口）
常见错误
“已达到Qiita API的速率限制”
原因: 达到请求限制
解决策：
- 等待错误消息显示的时间
- 设置Qiita访问令牌（60→1000请求/小时）
“未找到指定的文章”
原因: 文章ID错误或文章不公开/删除
解决策：
- 从URL确认文章ID
- 确认报道是否公开
错误处理
服务器提供实用的日语错误信息：
- 429（汇率限制）：
Retry-After显示页眉中的具体重试时间 - 404（未找到）： “没有找到文章”的明确信息
- 401（验证错误）： 通知访问标记无效
- 网络错误： 连接失败详细信息
机能一覧
-
三个智能工具
search_articles-搜索注重质量的文章get_tech_trends-单镜头趋势收集read_article_smart-一次获取文章+评论
-
令牌效率
- 使用cheerio进行HTML清理
- 智能文本填充（20000个字符限制）
- 减少噪音并保持信号
-
坚固的错误处理
- 速率限制检测（429）和具体重试时间的提示
- 实用日语错误信息
- 灰度深度
-
型安全性
- 完整的类型脚本实现
- 用于运行时验证的Zod架构
- 全面的错误类型定义
Disclaimer /免责事项
该工具允许用户使用官方Qiita API搜索和总结Qiita文章。
- 这是一个非官方工具，不隶属于Qiita股份有限公司。
- 请确保您遵守 Qiita的服务条款 和 API政策 使用此工具时。
- 开发者不对因使用此工具而产生的任何问题或损害负责。
本工具是使用Qiita官方API检索·概括报道的非正式工具。
许可证
IT许可证-了解更多信息许可证来修改标记元素的显示属性。
分发
欢迎分享！请随意发送Pull Request。
作者
赤木正吾
谢辞
- 模型上下文协议SDK使用构建
- Qiita API v2利用期间
