DevTo Agent
About
Build and deploy an autonomous Devto Agent capable of interacting with the Dev.to platform, powered by A2A (Agent-to-Agent) and MCP (Model Context Protocol)
Explore
- Fetch and manage DevTo articles by tags or authors
- Generate and post markdown content to DevTo
- Retrieve user profiles and reading lists
- Manage article comments and followers
- Supports both SSE and STDIO interfaces
- Python 3.10 or higher
- UVicorn for running servers
- DevTo API key
- Google API key (for agent functionality)
1. Clone the repository:
git clone https://github.com/HeetVekariya/devto-agent.git
cd devto-agent
2. Environment Configuration:
Create a .env file in the project root:
DEVTO_API_KEY=your_devto_api_key_here
DEVTO_BASE_URL=https://dev.to/api
GOOGLE_API_KEY=your_google_api_key_here
3. Install Dependencies:
uv pip install -e .
4. Start the Devto MCP Server
uv run mcp_servers/sse/devto_server.py
5. Start Devto Agent
uv run a2a_servers/agent_server/devto_agent.py
6. Start Host Agent:
uv run a2a_servers/agent_server/host_agent.py
7. Run the Client Application:
uv run main.py
Purpose: Bridge between A2A agents and MCP servers.
- Establishes connection to MCP server
- Provides async tool interface for agents
- Handles connection lifecycle management
Available through the MCP server:
- get_articles(page, per_page): Paginated article retrieval
- get_articles_by_tag(tag): Tag-based filtering
- get_article_content(article_id): Full article content
- post_article(title, body, tags): Article publishing
- get_user(): User profile information
- get_user_reading_list(): Saved articles
A comprehensive multi-agent system for interacting with Dev.to (DevTo) platform, built using Google ADK (Agent Development Kit) and Model Context Protocol (MCP). This project enables automated content creation, article management, and user profile interactions with DevTo through both Agent-to-Agent (A2A) communication and MCP server implementations.
You can find follow along blog here
Project Overview
This project implements a sophisticated agent architecture that can:
- Fetch and manage DevTo articles by tags or authors
- Generate and post markdown content to DevTo
- Retrieve user profiles and reading lists
- Manage article comments and followers
- Provide both SSE (Server-Sent Events) and STDIO interfaces for different integration needs
Table of Contents
- Architecture Overview
- Project Structure
- Component Details
- Setup and Installation
- API Reference
Architecture Overview
The project follows a modular architecture with three main communication patterns:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Client App │───▶│ A2A Server │───▶│ DevTo API │
│ (main.py) │ │ (devto_agent) │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ ▲
│ ▼ │
│ ┌─────────────────┐ │
└─────────────▶│ MCP Server │──────────────┘
│ (SSE/STDIO) │
└─────────────────┘
Key Components:
1. A2A Agent Server: High-level agent interface using Google ADK
2. MCP Servers: Low-level tool interface using Model Context Protocol
3. DevTo Service: Direct API integration with Dev.to
4. Tool Connectors: Bridge between agents and MCP servers
Project Structure
devto-agent/
├── a2a_servers/ # Agent-to-Agent server implementations
│ ├── agent_server/ # Individual agent definitions
│ │ ├── devto_agent.py # Main DevTo agent server
│ │ ├── host_agent.py # Host agent coordinator
│ │ └── utils.py # Agent utilities
│ ├── agents/ # Agent base classes and implementations
│ │ ├── adk_agent.py # Google ADK agent wrapper
│ │ └── utils/ # Agent utilities
│ └── common/ # Shared components
│ ├── client/ # A2A client implementations
│ ├── server/ # A2A server implementations
│ └── types.py # Common type definitions
├── connector/ # Tool connectors
│ └── tools/
│ └── devto_tools.py # DevTo MCP tool connector
├── mcp_servers/ # Model Context Protocol servers
│ ├── sse/ # Server-Sent Events implementation
│ │ └── devto_server.py # SSE-based MCP server
│ └── stdio/ # Standard I/O implementation
│ └── devto_server.py # STDIO-based MCP server
├── services/ # Core business logic
│ └── devto_service.py # DevTo API service wrapper
├── test/ # Test files
├── main.py # Main client application
└── pyproject.toml # Project dependencies
Component Details
1. A2A Servers (a2a_servers/)
Purpose: Implements high-level agent interfaces using Google ADK framework.
Key Files:
-devto_agent.py: Main DevTo agent that handles:
- Content generation for DevTo articles
- Article fetching and management
- User profile operations
- Article posting with markdown support
- host_agent.py: Coordinator agent that can manage multiple sub-agents
- adk_agent.py: Wrapper class that integrates Google ADK with MCP tools
2. MCP Servers (mcp_servers/)
Purpose: Provides low-level tool interfaces using Model Context Protocol.
SSE Implementation (sse/devto_server.py):
```pythonSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
