使用说明
Qiita MCP服务器
它是一种stdio服务器,可以通过MCP(Model Context Protocol)从AI中操作Qiita API v2的所有功能(68个工具)。
快速启动
1.获取访问令牌
Qiita设置页面 对较大场景进行渲染期间已观察到该故障。
2.Claude Desktop中使用
claude_desktop_config.json 中添加以下内容:
{
"mcpServers": {
"qiita-mcp": {
"command": "npx",
"args": ["-y", "@sunu-py-jp/qiita-mcp"],
"env": {
"QIITA_ACCESS_TOKEN": "your_token_here"
}
}
}
}
配置文件位置
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json- 窗户:
%APPDATA%\Claude\claude_desktop_config.json
3.Claude Code中使用
claude mcp add qiita -e QIITA_ACCESS_TOKEN=your_token -- npx -y @sunu-py-jp/qiita-mcp
4.其他MCP客户端
# npx で直接起動 (インストール不要)
QIITA_ACCESS_TOKEN=your_token npx -y @sunu-py-jp/qiita-mcp
# またはグローバルインストール
npm install -g @sunu-py-jp/qiita-mcp
QIITA_ACCESS_TOKEN=your_token qiita-mcp
用于Qiita Team
在Qiita Team中使用时 QIITA_BASE_URL 请添加环境变量:
{
"mcpServers": {
"qiita": {
"command": "npx",
"args": ["-y", "@sunu-py-jp/qiita-mcp"],
"env": {
"QIITA_ACCESS_TOKEN": "your_token_here",
"QIITA_BASE_URL": "https://your-team.qiita.com"
}
}
}
}
工具过滤
68如果不需要全部工具,则可以通过环境变量对组单位、工具单位进行过滤。
QIITA_ENABLED_GROUPS
以逗号分隔 カテゴリ:操作 中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
- 未设定:所有工具均已启用(默认设置)
- 仅类别:该类别的read/write都有效
- 类别:操作:仅适用于指定操作的工具
操作为 read(GET系)和 write(POST/PATCH/DELETE系列)2种。
类别列表: auth, authenticated_user, items, comments, tags, users, reactions, teams, groups, templates
QIITA_DISABLED_TOOLS
在逗号分隔符中指定工具名称,然后单独排除工具。QIITA_ENABLED_GROUPS 中所述修改相应参数的值。
设定例
{
"mcpServers": {
"qiita-mcp": {
"command": "npx",
"args": ["-y", "@sunu-py-jp/qiita-mcp"],
"env": {
"QIITA_ACCESS_TOKEN": "your_token_here",
"QIITA_ENABLED_GROUPS": "items:read,comments:read",
"QIITA_DISABLED_TOOLS": "list_item_stockers"
}
}
}
}
|用例|设置|结果|
|---|---|---|
只浏览文章 QIITA_ENABLED_GROUPS=items:read 5工具
报道的全部操作 QIITA_ENABLED_GROUPS=items 11工具
从文章操作中排除删除 QIITA_ENABLED_GROUPS=items + QIITA_DISABLED_TOOLS=delete_item 10工具
只排除特定工具 QIITA_DISABLED_TOOLS=delete_item,delete_comment [66]工具
授课工具列表(68 tools)
认证(auth)- 4 tools
工具|说明|
|--------|------|
| create_access_token 创建访问令牌
| delete_access_token |禁用访问令牌|
| create_team_access_token 为团队创建访问令牌
| delete_team_access_token |禁用团队访问令牌|
身份验证用户-2 tools
工具|说明|
|--------|------|
| get_authenticated_user 获取认证用户的信息
| list_authenticated_user_items 获取认证用户的文章列表
记事(items)- 11 tools
工具|说明|
|--------|------|
| list_items 获取文章列表(支持搜索查询)
| get_item 用ID获取文章
| create_item 制作报道
| update_item 更新文章
| delete_item 删除文章
| list_user_items 获取用户的文章列表
| list_user_stocks 获取用户的库存一览表
| list_item_stockers 获取存储文章的用户列表
| stock_item 储存报道
| unstock_item 解除报道的存货
| import_item 导入文章(仅限Team管理员)
注释-6tools
工具|说明|
|--------|------|
| list_item_comments 获取文章的评论列表
| create_comment 发布评论
| get_comment 获取注释
| update_comment 更新注释
| delete_comment 删除注释
| import_comment 导入注释(仅限Team管理员)
标记-8tools
工具|说明|
|--------|------|
| list_tags 获取标签列表
| get_tag 获取标记详细信息
| list_tag_items 获取标记的文章列表
| list_user_following_tags 获取用户正在跟踪的标签列表
| follow_tag 关注标签
| unfollow_tag 取消标记跟踪
| create_tagging 在文章中添加标记(仅Team)
| delete_tagging 从文章中删除标记(仅Team)
用户-9tools
工具|说明|
|--------|------|
| list_users 获取用户列表
| get_user 获取用户信息
| list_user_followees 获取正在跟踪的用户列表
| list_user_followers 获取粉丝列表
| follow_user 关注用户
| unfollow_user 取消用户跟踪
| check_user_following 确认跟踪状态
| list_item_likes 取得报道的好处一览表
| check_item_stock 确认报道的库存状态
反应-7tools
工具|说明|
|--------|------|
| create_item_reaction 在文章中追加图画文字反应
| list_item_reactions 获取文章的反应一览表
| delete_item_reaction 删除文章的反应
| create_comment_reaction 在评论中添加图画文字反应
| list_comment_reactions 获取评论的反应一览表
| delete_comment_reaction |删除评论的反应|
| create_project_comment_reaction 在项目注释中添加反应
团队-6tools
工具|说明|
|--------|------|
| list_teams 获取所属团队列表
| list_team_memberships 获取团队成员列表
| list_team_invitations 获取团队邀请列表
| create_team_invitation 邀请团队
| delete_team_invitation 取消团队邀请
| remove_team_member |删除团队成员|
组-9tools
工具|说明|
|--------|------|
| list_groups 获取组列表
| create_group 创建组
| get_group 获取组详细信息
| update_group 更新组
| delete_group |删除组|
| list_group_members 获取组成员列表
| add_group_member 向组中添加成员
| remove_group_member 从组中删除成员
| get_group_member 获取组成员信息
模板-6tools
工具|说明|
|--------|------|
| list_templates 获取模板列表
| create_template 创建模板
| get_template 获取模板
| update_template 更新模板
| delete_template 删除模板
| expand_template 部署模板变量
开発
git clone https://github.com/sunu-py-jp/Qiita-MCP.git
cd Qiita-MCP
npm install
npm run build
