MCP Server Qiita

🚀 MCP Server for Qiita

This is an MCP (Model Context Protocol) server for the Qiita API v2. It provides Japanese comments and documentation for Japanese users.

✨ Features

This MCP server offers the following Qiita API features:

User-related

• Retrieve authenticated user information
• Get detailed user information
• Fetch a list of users
• Obtain an article list of a specified user
• Get a stock list of a specified user
• Retrieve the follower and following lists of a specified user
• Follow or unfollow a specified user

Article-related

• Get an article list (with search functionality)
• Obtain detailed article information
• Create, update, or delete an article
• Stock or unstock an article
• Check the stock status of an article
• Fetch a list of stockers for an article

Tag-related

• Get a tag list (with sorting functionality)
• Obtain detailed tag information
• Fetch an article list for a specified tag
• Follow or unfollow a specified tag
• Check the follow status of a tag

Comment-related

• Get a comment list for an article
• Create, update, or delete a comment
• Obtain detailed comment information

📦 Installation

Prerequisites

• Node.js 18.0.0 or higher

Install from NPM (Recommended)

npm install -g mcp-server-qiita

Set up the development version

1. Clone the repository

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

2. Install dependencies

npm install

3. Build

npm run build

💻 Usage Examples

Set environment variables

To use the Qiita API, you need an access token. Set the following environment variable:

export QIITA_ACCESS_TOKEN="your_qiita_access_token_here"

You can generate an access token on the Qiita token settings page.

Start the server

pnpm start

Or start in development mode:

pnpm dev

Use with an MCP client

This server communicates with clients using the MCP protocol.

Example Cursor configuration (.cursor/mcp.json)

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

Available tools

The following tools are available:

User-related tools

• get_authenticated_user: Retrieve authenticated user information
• get_user: Get detailed information of a specified user
• get_users: Fetch a list of users
• get_user_items: Obtain an article list of a specified user
• get_user_stocks: Get a stock list of a specified user
• get_user_followers: Retrieve the follower list of a specified user
• get_user_followees: Obtain the following list of a specified user
• follow_user: Follow a specified user
• unfollow_user: Unfollow a specified user
• is_user_followed: Check if a specified user is being followed

Article-related tools

• get_items: Get an article list (with search functionality)
• get_item: Obtain detailed information of a specified article
• create_item: Create a new article
• update_item: Update an existing article
• delete_item: Delete a specified article
• stock_item: Stock a specified article
• unstock_item: Unstock a specified article
• is_item_stocked: Check if a specified article is stocked
• get_item_stockers: Fetch a list of stockers for a specified article

Tag-related tools

• get_tags: Get a tag list (with sorting functionality)
• get_tag: Obtain detailed information of a specified tag
• get_tag_items: Fetch an article list for a specified tag
• follow_tag: Follow a specified tag
• unfollow_tag: Unfollow a specified tag
• is_tag_followed: Check if a specified tag is being followed

Comment-related tools

• get_item_comments: Get a comment list for a specified article
• create_comment: Create a comment on a specified article
• update_comment: Update a specified comment
• delete_comment: Delete a specified comment
• get_comment: Obtain detailed information of a specified comment

🔧 Technical Details

Set up the development environment

# Install dependencies
pnpm install

# Type check
pnpm type-check

# Build
pnpm build

# Run in development mode
pnpm dev

Project structure

mcp-server-qiita/
├── src/
│   └── index.ts          # Main MCP server file
├── dist/                 # Build output directory
├── package.json          # Project settings
├── tsconfig.json         # TypeScript settings
└── README.md            # This file

📄 License

MIT License

🤝 Contribution

Pull requests and issue reports are welcome.

⚠️ Important Note

• This server uses the Qiita API v2.
• Valid access tokens are required for operations that need authentication (such as creating, updating, or deleting articles).
• Pay attention to the API rate limits (Authenticated requests: 1000 requests/hour, Unauthenticated requests: 60 requests/hour).
• All comments and documentation are written in Japanese.

🔗 Related Projects

MCP Server for Temporary Email

If you need a temporary email during development and testing, try mcp-server-tempmail.

mcp-server-tempmail is an MCP server for temporary email management using the ChatTempMail API. It seamlessly integrates the temporary email function into the AI development workflow and provides the following features:

• AI Integration: Native integration with popular AI tools such as Cursor, Claude, and VS Code Copilot.
• Real-time Monitoring: Instant notifications when an email arrives in the temporary inbox.
• Privacy Protection: Keep your actual email address private during development and testing.
• Easy Setup: Easily configure with just a few lines of JSON.
• Flexible Configuration: Customize email expiration and Webhook settings.

# Install from NPM
npm install -g mcp-server-tempmail

For more details, visit the official website.