sbmagar13/hashnode-mcp-server

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

7 stars 8 forks 品質 80 トレンド 19MIT

A Model Context Protocol (MCP) server that connects AI assistants to the Hashnode API, enabling seamless content creation, management, and retrieval through AI interactions.

概要

A Model Context Protocol (MCP) server for interacting with the Hashnode API. This server provides tools for accessing and searching Hashnode content programmatically. - 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 2. Create a virtual environment and activate it: 4. Create a .env file in the root directory with your Hashnode API credentials: You have two options for running the server: 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. When properly configured in Claude Desktop or Cline VSCode extension, the MCP integration will automatically start and manage the server process for you. When configuring your MCP server in Claude Desktop or Cline VSCode extension, you should use the root mcp_server.

README

以下は原文 README の抜粋です。原文を見る。

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

Clone the repository:

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

Create a virtual environment and activate it:

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

Install the dependencies:
```
pip install -r requirements.txt
```

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

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
     "mcpServers": {
       "hashnode": {
         "command": "/path/to/your/venv/bin/python",
         "args": [
           "/path/to/your/hashnode-mcp-server/mcp_server.py"
         ],
         "env": {
           "HASHNODE_PERSONAL_ACCESS_TOKEN": "your-personal-access-token"
         }
       }
     }
   }