# π Dev.To Articles MCP Server
<div align="center">




</div>
## π― What is this project?
This is a complete MCP (Model Context Protocol) server that implements a articles of dev.to with robust validation using **TypeScript** and **Zod**. The server integrates directly with **Cursor**, allowing you search articles on dev.to.
### π Why use MCP?
The **Model Context Protocol** is a protocol developed by Anthropic that allows AI assistants to connect with external tools and resources in a standardized way. With this project, you can:
- π€ **Natural Conversation** with Cursor about articles on dev.to
- π§ **Execute tasks** directly through chat
- π **Receive Insights** smart data about published data
- π‘οΈ **Ensure data validation** robust of all data
## Usage Examples
Ask on Cursors:
- "Give me 3 articles about typescript"
- "Give me articles of user kevin-uehara"
## How It Works
`get-articles`
1. Fetches articles passing parameter **tag** and **quantity** from Dev.TO API
2. Returns structured data that AI agents can format beautifully
`get-articles-by-user-name`
1. Fetches articles passing parameter **username** from Dev.TO API
2. Returns structured data that AI agents can format beautifully
## ποΈ Project Architecture
The project is organized with three main files
```
src/
βββ types.ts # π Zod Types
βββ service.ts # π₯οΈ Integration with dev.to
βββ main.ts # π Entry Point of MCP
```
## Dependencies
- `@modelcontextprotocol/sdk` - MCP server framework
- `zod` - Schema validation
## API Used
- [Dev.To API](https://developers.forem.com/api/v0) - Free API of Dev.TO articles