JinDaGe - mcp-server-qiita MCP Details

article

README

🚀 Qiita MCP服务器

这是一个用于Qiita API v2的MCP（模型上下文协议）服务器。它为日本用户提供日语注释和文档，助力用户更便捷地使用Qiita API。

🚀 快速开始

本MCP服务器提供了丰富的Qiita API功能，要使用它，需先完成安装和环境配置。

✨ 主要特性

此MCP服务器提供了以下Qiita API功能：

用户相关

获取已认证用户信息
获取用户详细信息
获取用户列表
获取用户的文章列表
获取用户的收藏列表
获取用户的粉丝和关注列表
关注/取消关注用户

文章相关

获取文章列表（附带搜索功能）
获取文章详细信息
创建、更新、删除文章
收藏/取消收藏文章
确认文章的收藏状态
获取文章的收藏者列表

标签相关

获取标签列表（附带排序功能）
获取标签详细信息
获取标签下的文章列表
关注/取消关注标签
确认标签的关注状态

评论相关

获取文章的评论列表
创建、更新、删除评论
获取评论详细信息

📦 安装指南

前提条件

Node.js 18.0.0 及以上版本

从NPM安装（推荐）

npm install -g mcp-server-qiita

开发版的设置

克隆仓库

git clone https://github.com/selenium39/mcp-server-qiita.git
cd mcp-server-qiita

安装依赖

npm install

构建项目

npm run build

💻 使用示例

环境变量的设置

使用Qiita API需要访问令牌，请设置以下环境变量：

export QIITA_ACCESS_TOKEN="your_qiita_access_token_here"

访问令牌可在Qiita的令牌设置页面生成。

启动服务器

pnpm start

或者以开发模式启动：

pnpm dev

在MCP客户端中使用

此服务器使用MCP协议与客户端通信。

Cursor设置示例 (.cursor/mcp.json)

{
  "mcpServers": {
    "qiita": {
      "command": "mcp-server-qiita",
      "env": {
        "QIITA_ACCESS_TOKEN": "your_qiita_access_token_here"
      }
    }
  }
}

可用工具

以下是一些可用的工具：

用户相关工具

get_authenticated_user：获取已认证用户信息
get_user：获取指定用户的详细信息
get_users：获取用户列表
get_user_items：获取指定用户的文章列表
get_user_stocks：获取指定用户的收藏列表
get_user_followers：获取指定用户的粉丝列表
get_user_followees：获取指定用户的关注列表
follow_user：关注指定用户
unfollow_user：取消关注指定用户
is_user_followed：确认是否关注指定用户

文章相关工具

get_items：获取文章列表（附带搜索功能）
get_item：获取指定文章的详细信息
create_item：创建新文章
update_item：更新现有文章
delete_item：删除指定文章
stock_item：收藏指定文章
unstock_item：取消收藏指定文章
is_item_stocked：确认指定文章是否被收藏
get_item_stockers：获取指定文章的收藏者列表

标签相关工具

get_tags：获取标签列表（附带排序功能）
get_tag：获取指定标签的详细信息
get_tag_items：获取指定标签下的文章列表
follow_tag：关注指定标签
unfollow_tag：取消关注指定标签
is_tag_followed：确认是否关注指定标签

评论相关工具

get_item_comments：获取指定文章的评论列表
create_comment：在指定文章下创建评论
update_comment：更新指定评论
delete_comment：删除指定评论
get_comment：获取指定评论的详细信息

📚 详细文档

开发环境的设置

# 安装依赖
pnpm install

# 类型检查
pnpm type-check

# 构建项目
pnpm build

# 在开发模式下运行
pnpm dev

项目结构

mcp-server-qiita/
├── src/
│   └── index.ts          # 主MCP服务器文件
├── dist/                 # 构建输出目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript配置
└── README.md            # 本文件

📄 许可证

本项目采用 MIT 许可证。

🔗 贡献

欢迎提交拉取请求和报告问题。

⚠️ 重要提示

此服务器使用 Qiita API v2。
需认证的操作（如文章的创建、更新、删除等）需要有效的访问令牌。
请注意 API 速率限制（已认证请求：1000 次/小时，未认证请求：60 次/小时）。
所有注释和文档均使用日语编写。

🔗 相关项目

临时邮件MCP服务器

如果在开发和测试时需要临时邮件，可尝试使用 mcp-server-tempmail。

mcp-server-tempmail 是一个使用 ChatTempMail API 进行临时邮件管理的 MCP 服务器。它能将临时邮件功能无缝集成到 AI 开发工作流程中，并提供以下功能：

AI 集成：与 Cursor、Claude、VS Code Copilot 等流行 AI 工具进行原生集成。
实时监控：当临时收件箱收到邮件时立即通知。
隐私保护：在开发和测试过程中保护实际邮箱地址的隐私。
简单设置：只需几行 JSON 配置即可轻松完成设置。
灵活配置：可自定义邮件有效期和 Webhook 设置。

# 从NPM安装
npm install -g mcp-server-tempmail

更多详情请访问官方网站。

mcp-server-qiita