mcp-py-devto

This MCP server provides a Python-based integration with dev.to, enabling message-driven interactions with the dev.to API. It exposes endpoints for creating, updating, deleting, and retrieving articles, and supports message-based routing and basic RESTful communication to manage content on dev.to. You can interact with the server via the built-in client library or direct HTTP requests to the provided endpoints. The server listens on the configured port (default 8080) and is designed to be run within a Python environment with the required API key.

To operate it, ensure you have a valid dev.to API key and set it in the environment or configuration. Use the included MCP client to send messages with actions such as create_article, update_article, delete_article, and get_article, providing the necessary data like title, content, and article_id. The server will handle routing, queuing, and real-time updates to reflect changes on dev.to.

Prerequisites:

• Python 3.11 or higher
• pip (Python package manager)
• dev.to API key

Installation steps:

1. Clone the repository and navigate to the project:

git clone https://github.com/yourusername/mcp-py-devto.git
cd mcp-py-devto

2. Create and activate a virtual environment:

python -m venv venv
# Windows
venv\Scripts\activate
# Unix/macOS
source venv/bin/activate

3. Build/install the Python package from the repository (local development install):

pip install .

4. Configure the API key by setting DEVTO_API_KEY in your environment or in the project configuration (see Configuration section in README).

5. Run the MCP server (via the Python module entry point):

# Example (from project root, with proper environment variable set):
python -m mcp_py_devto

Note: If you prefer running via an IDE, open the project in VSCode, configure DEVTO_API_KEY in .vscode/mcp.json, and start the server using the Start button.

Tips and notes:

• Ensure you have a valid dev.to API key and grant the necessary permissions for article management.
• Set DEVTO_API_KEY in your environment or in the configured mcp.json so the server can authenticate requests to dev.to.
• The server exposes endpoints such as POST /message, GET /status, and GET /metrics for monitoring and control.
• If you encounter authentication or rate-limit issues, verify your API key and review dev.to API rate limits.
• For local development, use a virtual environment to manage dependencies and avoid conflicts with system Python.
• When changing code, reinstall the package (pip install .) or run in editable mode if supported by your setup.
• If your deployment requires a different port, check the server configuration to modify the listening port accordingly.