Dev.to MCP Server

A remote Model Context Protocol (MCP) server for interacting with the dev.to public API without requiring authentication.

Features

This MCP server provides access to the following dev.to public API endpoints:

• get_articles - Get articles from dev.to with optional filters (username, tag, state, pagination)
• get_article - Get a specific article by ID or path
• get_user - Get user information by ID or username
• get_tags - Get popular tags from dev.to
• get_comments - Get comments for a specific article
• search_articles - Search articles using query parameters

Installation

npm install
npm run build

Usage

The server runs as a remote HTTP server on port 3000 (or the PORT environment variable) and can be used with any MCP-compatible client.

npm start

The server will be available at http://localhost:3000 for MCP connections.

Development

# Build the project
npm run build

# Watch mode for development
npm run dev

# Linting
npm run lint
npm run lint:fix

# Formatting
npm run format
npm run format:check

Docker

Build and run the MCP server using Docker:

# Build the Docker image
docker build -t dev-to-mcp .

# Run the container
docker run -p 3000:3000 dev-to-mcp

The server will be available at http://localhost:3000/mcp for MCP connections.

Docker Compose

For easier development, you can also use Docker Compose:

# docker-compose.yml
version: '3.8'
services:
  dev-to-mcp:
    build: .
    ports:
      - "3000:3000"
    environment:
      - PORT=3000

docker-compose up --build

API Endpoints

All endpoints use the public dev.to API (https://dev.to/api) and do not require authentication.

get_articles

Get articles with optional filtering:

• username - Filter by author username
• tag - Filter by tag
• top - Top articles (1, 7, 30, or infinity days)
• page - Pagination page (default: 1)
• per_page - Articles per page (default: 30, max: 1000)
• state - Filter by state (fresh, rising, all)

get_article

Get a specific article:

• id - Article ID
• path - Article path (e.g., "username/article-slug")

get_user

Get user information:

• id - User ID
• username - Username

get_tags

Get popular tags:

• page - Pagination page (default: 1)
• per_page - Tags per page (default: 10, max: 1000)

get_comments

Get comments for an article:

• article_id - Article ID (required)

search_articles

Search articles:

• q - Search query (required)
• page - Pagination page (default: 1)
• per_page - Articles per page (default: 30, max: 1000)
• search_fields - Fields to search (title, body_text, tag_list)

License

MIT