星战科技xingzhan.cloud
返回市场
哈希节点MCP服务器

哈希节点MCP服务器

作者：sbmagar135 星标更新：2025-06-30
安装使用来源：spider==github.com

项目介绍

Hashnode MCP Server

这是一个用于与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

使用方法

启动服务器

运行服务器有两种选择：

方案1：手动启动服务器

python run_server.py

或者直接使用根文件：

python mcp_server.py

服务器将启动并监听来自AI助手的连接。默认情况下，它在localhost:8000上运行，使用Server-Sent Events（SSE）传输协议。

方案2：让MCP集成自动处理

当在Claude Desktop或Cline VSCode扩展中正确配置时，MCP集成会自动启动并管理服务器进程。

关于文件结构的重要说明

在Claude Desktop或Cline VSCode扩展中配置你的MCP服务器时，你应该直接使用根mcp_server.py文件，而不是hashnode_mcp目录中的文件。hashnode_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应用程序

环境变量

  • HASHNODE_PERSONAL_ACCESS_TOKEN: 你的Hashnode个人访问令牌
  • HASHNODE_API_URL: Hashnode GraphQL API URL（默认值：https://gql.hashnode.com）

贡献

欢迎贡献！请随时提交Pull Request。

  1. 分叉仓库
  2. 创建你的功能分支（git checkout -b feature/amazing-feature）
  3. 提交更改（git commit -m 'Add some amazing feature'）
  4. 推送到分支（git push origin feature/amazing-feature）
  5. 打开Pull Request

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

GitHub仓库

该项目的源代码可在GitHub上找到： https://github.com/sbmagar13/hashnode-mcp-server

技术架构

项目组织结构清晰、模块化：

  • mcp_server.py: 可直接运行的根服务器实现
  • hashnode_mcp/: 包含核心模块化功能的核心包
    • mcp_server.py: 包版本的服务器实现
    • utils.py: 用于响应格式化和GraphQL查询的实用函数
  • run_server.py: 使用包版本运行服务器的入口点

服务器使用Python的asyncio和httpx库进行异步编程，以实现高效的API通信。GraphQL查询和突变定义为常量，便于维护和更新。

未来增强

计划的未来发展包括：

  • 增加Hashnode功能（评论、系列、新闻通讯）
  • 数据分析集成
  • 内容优化
  • 多用户支持
  • Webhook支持

致谢