Hashnode MCP Server

🚀 Hashnode MCP 服務器

Hashnode MCP 服務器是一個用於與 Hashnode API 交互的模型上下文協議（MCP）服務器。該服務器提供了以編程方式訪問和搜索 Hashnode 內容的工具。

🚀 快速開始

安裝

1. 克隆倉庫：

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

2. 創建並激活虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上使用: .venv\Scripts\activate
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

4. 在根目錄下創建一個 .env 文件，並添加你的 Hashnode API 憑證：

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

啟動服務器

你有兩種方式來運行服務器：

方式一：手動運行服務器

python run_server.py

或者直接使用根文件：

python mcp_server.py

服務器將啟動並監聽來自 AI 助手的連接。默認情況下，它使用服務器發送事件（SSE）傳輸協議在 localhost:8000 上運行。

方式二：讓 MCP 集成自動處理

當在 Claude Desktop 或 Cline VSCode 擴展中正確配置後，MCP 集成將自動為你啟動和管理服務器進程。

✨ 主要特性

• 創建併發布新文章
• 更新現有文章
• 按關鍵詞搜索文章
• 獲取文章詳情
• 獲取用戶信息
• 從出版物中獲取最新文章

📦 安裝指南

克隆倉庫

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

創建並激活虛擬環境

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用: .venv\Scripts\activate

安裝依賴

pip install -r requirements.txt

配置環境變量

在根目錄下創建 .env 文件，添加 Hashnode API 憑證：

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

💻 使用示例

啟動服務器

手動啟動

python run_server.py

或

python mcp_server.py

自動啟動

在 Claude Desktop 或 Cline VSCode 擴展中正確配置後，MCP 集成將自動啟動和管理服務器進程。

可用工具

• test_api_connection()：測試與 Hashnode API 的連接
• create_article(title, body_markdown, tags="", published=False)：在 Hashnode 上創建併發布新文章
• update_article(article_id, title=None, body_markdown=None, tags=None, published=None)：更新 Hashnode 上的現有文章
• get_latest_articles(hostname, limit=10)：按主機名從 Hashnode 出版物中獲取最新文章
• search_articles(query, page=1)：在 Hashnode 上搜索文章
• get_article_details(article_id)：獲取特定文章的詳細信息
• get_user_info(username)：獲取 Hashnode 用戶的信息

使用 MCP 服務器

服務器啟動後，你可以將其與支持模型上下文協議（MCP）的 AI 助手（如 Claude）一起使用。助手將能夠使用服務器提供的工具與 Hashnode API 進行交互。這些工具可用於：

• 測試 API 連接
• 創建併發布新文章
• 更新現有文章
• 從出版物中獲取最新文章
• 搜索文章
• 獲取特定文章的詳細信息
• 獲取用戶信息

📚 詳細文檔

在 Claude Desktop 和 Cline VSCode 擴展上配置 MCP

Cline VSCode 擴展

1. 導航到 Cline MCP 設置文件：
   • 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：目前 Claude Desktop 不適用於 Linux（你可以使用 Cline 擴展代替）
2. 添加你的 Hashnode MCP 服務器配置：

{
  "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"
      }
    }
  }
}

Claude Desktop

1. 導航到配置文件：
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
2. 使用上述相同的格式添加你的 Hashnode MCP 服務器配置。

解決連接問題

如果你遇到連接問題：

• 驗證服務器是否正在運行
• 檢查配置中的路徑
• 確保你的環境變量已正確設置
• 檢查服務器日誌中是否有錯誤消息
• 嘗試重新啟動 MCP 服務器和 Claude 應用程序

🔧 技術細節

項目結構

該項目採用清晰的模塊化結構：

• mcp_server.py：可直接運行的根服務器實現
• hashnode_mcp/：包含模塊化功能的核心包
  • mcp_server.py：包版本的服務器實現
  • utils.py：用於格式化響應和 GraphQL 查詢的實用函數
• run_server.py：使用包版本運行服務器的入口點

技術實現

服務器使用 Python 的 asyncio 和 httpx 庫進行異步編程，以實現高效的 API 通信。GraphQL 查詢和突變被定義為常量，便於維護和更新。

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🔗 GitHub 倉庫

本項目的源代碼可在 GitHub 上獲取： https://github.com/sbmagar13/hashnode-mcp-server

🌟 未來增強功能

計劃中的未來開發包括：

• 更多 Hashnode 功能（評論、系列、時事通訊）
• 分析集成
• 內容優化
• 多用戶支持
• 網絡鉤子支持

🙏 致謝

• Hashnode 提供 API
• Model Context Protocol (MCP) 提供服務器框架
• 本項目由 MCP Review 認證

演示

創建文章

更新文章

重要提示

⚠️ 重要提示

在 Claude Desktop 或 Cline VSCode 擴展中配置 MCP 服務器時，你應該直接使用根 mcp_server.py 文件，而不是 hashnode_mcp 目錄中的文件。hashnode_mcp 目錄主要用於打包目的。

環境變量

貢獻

歡迎貢獻！請隨時提交拉取請求。

1. 分叉倉庫
2. 創建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求