Hashnode MCP Server

A Model Context Protocol (MCP) server for interacting with the Hashnode API. This server provides tools for accessing and searching Hashnode content programmatically.

Demo

• Create Article
• Update Article

Features

• Creating and publishing new articles
• Updating existing articles
• Searching for articles by keywords
• Retrieving article details
• Getting user information
• Fetching the latest articles from a publication

Installation

1. Clone the repository:

   git clone https://github.com/sbmagar13/hashnode-mcp-server.git
   cd hashnode-mcp-server
   

2. Create a virtual environment and activate it:

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
   

3. Install the dependencies:

   pip install -r requirements.txt
   

4. Create a .env file in the root directory with your Hashnode API credentials:

   HASHNODE_PERSONAL_ACCESS_TOKEN=your_personal_access_token
   HASHNODE_API_URL=https://gql.hashnode.com
   

Usage

Starting the Server

You have two options for running the server:

Option 1: Run the server manually

python run_server.py

Or directly using the root file:

python mcp_server.py

The server will start and listen for connections from AI assistants. By default, it runs on localhost:8000 using the Server-Sent Events (SSE) transport protocol.

Option 2: Let the MCP integration handle it automatically

When properly configured in Claude Desktop or Cline VSCode extension, the MCP integration will automatically start and manage the server process for you.

Important Note on File Structure

When configuring your MCP server in Claude Desktop or Cline VSCode extension, you should use the root mcp_server.py file directly rather than the files in the hashnode_mcp directory. The hashnode_mcp directory is primarily for packaging purposes.

Available Tools

The server provides the following tools:

• test_api_connection(): Test the connection to the Hashnode API
• create_article(title, body_markdown, tags="", published=False): Create and publish a new article on Hashnode
• update_article(article_id, title=None, body_markdown=None, tags=None, published=None): Update an existing article on Hashnode
• get_latest_articles(hostname, limit=10): Get the latest articles from a Hashnode publication by hostname
• search_articles(query, page=1): Search for articles on Hashnode
• get_article_details(article_id): Get detailed information about a specific article
• get_user_info(username): Get information about a Hashnode user

Using the MCP Server

Once the server is running, you can use it with AI assistants that support the Model Context Protocol (MCP), such as Claude. The assistant will be able to use the tools provided by the server to interact with the Hashnode API.

The tools can be used to:

• Test the API connection
• Create and publish new articles
• Update existing articles
• Get the latest articles from a publication
• Search for articles
• Get detailed information about specific articles
• Get information about users

Configuring MCP on Claude Desktop and Cline VSCode Extension

Cline VSCode Extension

1. Navigate to the Cline MCP settings file:

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings\cline_mcp_settings.json
   • Linux: Unfortunately, Claude Desktop is not available for Linux as of now (You can use Cline extension instead)

2. Add your Hashnode MCP se

... View full README on GitHub