qiita

This MCP server provides tools to interact with the Qiita platform through the MCP protocol. It exposes commands for listing your articles, fetching a specific article, creating new articles, updating existing ones, and retrieving Qiita markdown rules. Use these tools by starting the MCP server in your environment (for example via npx as configured) and then invoking the available MCP tools in your agent or automation workflow. The primary capabilities let AI agents read and manage Qiita content programmatically, enabling tasks such as drafting posts, updating content, and validating your article formatting against Qiita's markdown guidance.

Prerequisites:

• Node.js (≥ 20.0.0)
• npm (comes with Node.js)
• A Qiita account with an API access token

Installation steps:

1. Ensure Node.js is installed. You can verify with: node -v npm -v

2. Install dependencies and set up the MCP server locally by cloning the repository: git clone https://github.com/2bo/qiita-mcp-server.git cd qiita-mcp-server

3. Install project dependencies: npm install

4. Run or prepare the server for publishing (per project scripts): npm run dev # if you want TypeScript in watch mode for development npm run build # to build the project for production npm run prepare # to prepare the package for publishing

5. Run the MCP server via npx as described in the usage section, supplying your Qiita API token when prompted or via environment variables.

Notes:

• Replace placeholders with your actual Qiita API token (QIITA_API_TOKEN).
• If you modify environment variables, ensure they are available to the process executing the MCP server.

Tips and notes:

• The Qiita API token should have appropriate scopes for reading and writing articles as required by your workflow.
• If you encounter rate limits from Qiita, consider handling retries with backoff in your agent integration.
• Ensure the environment variable QIITA_API_TOKEN is kept secure and not exposed in logs or error messages.
• When using the get_qiita_markdown_rules tool, you can verify markdown syntax compatibility with Qiita's rules to improve content rendering.
• If you plan to publish to a different environment (prod/stage), maintain separate tokens and avoid reusing tokens across environments without proper scoping.