Hashnode MCP Server

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  # On Windows, use: .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 助手的连接。默认情况下，它会使用服务器发送事件（SSE）传输协议在 localhost:8000 上运行。

选项 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：Unfortunately, Claude Desktop is not available for Linux as of now（你可以改用 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. Fork 此仓库
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 授权，详情请参阅 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 支持

致谢

• 感谢 Hashnode 提供 API
• 感谢 Model Context Protocol (MCP) 提供服务框架
• 本项目已通过 MCP Review 认证