Dev Blog MCP Server
Enables publishing blog posts directly to Dev.to, supporting markdown content, tags, series, cover images, and draft or immediate publication.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Dev Blog MCP Server publish a draft blog post about the MCP protocol with tags mcp, ai, tutorial"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Dev Blog MCP Server
A Model Context Protocol (MCP) server that enables AI assistants to publish blog posts directly to Dev.to. This server provides a seamless way to integrate blog publishing capabilities into your AI workflows.
Features
š Direct Dev.to Publishing: Publish blog posts directly to Dev.to via MCP
š Rich Content Support: Full Markdown support with tags, series, and cover images
š Secure API Integration: Uses environment variables for API key management
š ļø Easy Integration: Simple setup with uv package manager
š Comprehensive Logging: Detailed logging for debugging and monitoring
Related MCP server: Dev.to Blog Publisher MCP Server
Prerequisites
Before you begin, ensure you have the following installed:
Python 3.13+
uv (Python package manager)
Git (for version control)
Dev.to API Key (get it from Dev.to Settings)
Installation
1. Install uv (if not already installed)
# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
# Or using pip
pip install uv2. Clone the Repository
git clone https://github.com/anuragck2/dev-blog-mcp-server.git
cd dev-blog-mcp-server3. Install Dependencies
# Install project dependencies using uv
uv sync4. Environment Setup
Create a .env file in the project root:
# Copy the example environment file
cp .env.example .env
# Edit the .env file and add your Dev.to API key
echo "DEVTO_API_KEY=your_devto_api_key_here" > .envGet your Dev.to API key:
Go to Dev.to Settings
Scroll down to the "API Keys" section
Generate a new API key
Copy the key and add it to your
.envfile
Usage
Running the MCP Server
# Activate the virtual environment and run the server
uv run python main.pyThe server will start and listen for MCP connections via stdio transport.
Using with MCP Inspector
The MCP Inspector is a powerful tool for testing and debugging MCP servers. Here's how to set it up:
1. Install MCP Inspector
# Install MCP Inspector globally
npm install -g @modelcontextprotocol/inspector2. Configure MCP Inspector
Create a configuration file for the MCP Inspector:
{
"mcpServers": {
"dev-blog-mcp-server": {
"command": "uv",
"args": ["run", "python", "main.py"],
"cwd": "/path/to/your/dev-blog-mcp-server"
}
}
}3. Run MCP Inspector
# Start the MCP Inspector
mcp-inspectorThis will open a web interface where you can:
Test the
publish_blog_to_devtotoolView server logs
Debug MCP communication
Monitor tool execution
Using with Claude Desktop
To use this MCP server with Claude Desktop:
Open Claude Desktop Settings
Add MCP Server Configuration
Add the following to your Claude Desktop configuration:
{
"mcpServers": {
"dev-blog-mcp-server": {
"command": "uv",
"args": ["run", "python", "main.py"],
"cwd": "/path/to/your/dev-blog-mcp-server"
}
}
}Restart Claude Desktop
After adding the configuration, restart Claude Desktop to load the new MCP server.
API Reference
publish_blog_to_devto Tool
Publishes a blog post to Dev.to with the following parameters:
Parameter | Type | Required | Description |
| string | ā | The title of the blog post |
| string | ā | The content in Markdown format |
| List[string] | ā | List of tags (e.g., ["python", "webdev"]) |
| boolean | ā | Set to |
| string | ā | The name of the series this article belongs to |
| string | ā | Canonical URL if cross-posted |
| string | ā | URL of the cover image |
Example Usage
# Example tool call
publish_blog_to_devto(
title="Getting Started with MCP",
body_markdown="# Introduction\n\nThis is a great article about MCP!",
tags=["mcp", "ai", "tutorial"],
published=False, # Save as draft
series="MCP Fundamentals"
)Development
Project Structure
dev-blog-mcp-server/
āāā main.py # Main MCP server implementation
āāā pyproject.toml # Project configuration and dependencies
āāā .env.example # Environment variables template
āāā sample_prompt.md # Sample prompts for testing
āāā README.md # This file
āāā uv.lock # Dependency lock fileAdding New Features
Add new tools by creating functions decorated with
@mcp.tool()Update dependencies in
pyproject.tomlTest with MCP Inspector before deploying
Update documentation in this README
Testing
# Run the server in development mode
uv run python main.py
# Test with MCP Inspector
mcp-inspectorTroubleshooting
Common Issues
"DEVTO_API_KEY environment variable not set"
Ensure your
.envfile exists and contains the correct API keyVerify the API key is valid and has the necessary permissions
"Network or API request error"
Check your internet connection
Verify the Dev.to API is accessible
Ensure your API key has not expired
MCP Inspector connection issues
Verify the server is running
Check the configuration file paths
Ensure all dependencies are installed
Debug Mode
Enable debug logging by modifying the logging level in main.py:
logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
š§ Issues: GitHub Issues
š Documentation: MCP Documentation
š¦ Twitter: @anuragck2
Acknowledgments
Model Context Protocol for the amazing MCP framework
Dev.to for providing the publishing API
uv for the fast Python package manager
FastMCP for the excellent MCP server framework
Happy Blogging! š
Available Tools
1 toolpublish_blog_to_devtoA
Publishes a blog post to dev.to.
Args: title (str): The title of the blog post. body_markdown (str): The content of the blog post in Markdown format. tags (Optional[List[str]]): A list of tags for the blog post (e.g., ["python", "webdev"]). published (bool): Set to True to publish immediately, False to save as a draft. series (Optional[str]): The name of the series this article belongs to. canonical_url (Optional[str]): The canonical URL of the article if it's cross-posted. cover_image (Optional[str]): URL of the cover image for the article.
Returns: str: A message indicating the success or failure of the publishing operation, including the article URL if successful.
Inputs: title (required), body_markdown (required), tags, series, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogā¦
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or misselection. The tool's purpose is clear from its name and description.
The single tool name 'publish_blog_to_devto' is descriptive and follows a verb-object pattern, though it's somewhat verbose. Since there is only one tool, consistency is trivially maintained.
A single tool for a blog publishing server is extremely thin. Typical blog workflows require listing, editing, and deleting posts, so one tool is insufficient for the apparent scope.
The tool only supports publishing, with no ability to retrieve, update, or delete existing posts. This leaves significant gaps in the content lifecycle and would force agents to use external APIs.
Maintenance
Related MCP Connectors
Publish blog posts, send newsletters and emails from Claude, Claude Code, Codex and ChatGPT.
Publish and share Markdown/HTML docs from AI assistants. Requires grtwo.app Pro. OAuth or API key.
Publish and schedule social posts across your PostingCat accounts from AI agents.
Publish articles and notes under your own byline, to a readership of other AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to programmatically interact with the Hashnode API for creating, updating, searching, and retrieving blog content.7MIT
- AlicenseAqualityCmaintenanceEnables publishing blog posts directly to Dev.to through the Model Context Protocol, allowing seamless content creation and publication via natural language interactions.1MIT
- FlicenseNot gradedqualityDmaintenanceProvides MCP tools to interact with Dev.to, enabling searching, browsing, and publishing articles through natural language.-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Dev.to platform through MCP tools, including article search, retrieval, and creation.-