JinDaGe - qiita-mcp-server MCP Details

article

README

🚀 Qiita MCP 服务器

Qiita MCP 服务器是一个用于与工程师知识共享平台 Qiita 交互的模型上下文协议（MCP）服务器，它允许 AI 代理通过标准化的 MCP 工具与 Qiita API 进行交互，实现文章的创建、读取和更新等操作。

🚀 快速开始

此包提供了一个实现 MCP 规范的服务器，允许 AI 代理通过标准化的 MCP 工具与 Qiita API 进行交互，支持创建、读取和更新 Qiita 上的文章。MCP 是一个开放协议，用于构建可以使用外部工具和服务的 AI 代理，此服务器实现了 MCP 规范，提供了用于处理 Qiita 内容的工具。

✨ 主要特性

该服务器提供了一系列 MCP 工具，具体如下： | 工具名称 | 描述 | |----------|------| | get_my_qiita_articles | 获取当前已认证用户的 Qiita 文章 | | get_qiita_item | 通过 ID 获取特定的 Qiita 文章 | | post_qiita_article | 在 Qiita 上创建新文章 | | update_qiita_article | 更新现有的 Qiita 文章 | | get_qiita_markdown_rules | 获取 Qiita Markdown 格式规则和快捷键说明 |

📦 安装指南

先决条件

Node.js（>=20.0.0）
带有 API 访问令牌的 Qiita 账户
- 可通过以下链接生成 Qiita API 令牌：https://qiita.com/settings/tokens/new

在 VS Code 中使用

在项目中创建一个 .vscode/mcp.json 文件，内容如下：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "qiita-api-token",
      "description": "Qiita API Token",
      "password": true
    }
  ],
  "servers": {
    "qiita-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@2bo/qiita-mcp-server"],
      "env": {
        "QIITA_API_TOKEN": "${input:qiita-api-token}"
      }
    }
  }
}

💻 使用示例

基础用法

在 VS Code 中使用时，按照上述步骤创建 .vscode/mcp.json 文件后，即可利用服务器提供的 MCP 工具与 Qiita API 进行交互。例如，若要获取当前已认证用户的 Qiita 文章，可在合适的环境中调用 get_my_qiita_articles 工具。

🔧 技术细节

开发设置

克隆仓库：

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

安装依赖项：

npm install

配置环境：

npm run dev - 开发模式下运行 TypeScript 且带有热重载
npm run build - 构建项目
npm run prepare - 准备发布包

贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目使用 MIT 许可证，详情请参阅 LICENSE 文件。

qiita-mcp-server