mcp-server-hatena-weekly 0.1.0

Hatena Bookmark Weekly/Monthly Ranking MCP server for fetching popular bookmarks

Hatena Bookmark Weekly/Monthly Ranking MCP Server

An MCP server that provides Hatena Bookmark weekly and monthly ranking data. Contains data from January to May 2025.

🛠️ Available Tools

weekly - Weekly Ranking Retrieval

Description: Retrieve weekly Hatena bookmark rankings (30 entries) for a specified week

Parameters:

• year (integer, required): Year (2025 only)
• month (integer, required): Month (1-5)
• week (integer, required): Week number (1-5, week 5 only exists in March)

monthly - Monthly Ranking Retrieval

Description: Retrieve monthly Hatena bookmark rankings (50 entries) for a specified month

Parameters:

• year (integer, required): Year (2025 only)
• month (integer, required): Month (1-5)

Installation

Using uv (Recommended)

No special installation is required when using uv. You can run mcp-server-hatena-weekly directly using uvx.

Using PIP

Alternatively, you can install mcp-server-hatena-weekly using pip:

pip install mcp-server-hatena-weekly

After installation, you can run the script as follows:

mcp-server-hatena-weekly

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

{
  "mcpServers": {
    "hatena-weekly": {
      "command": "uvx",
      "args": ["mcp-server-hatena-weekly"]
    }
  }
}

Configure for VS Code

For quick installation, use one of the one-click install buttons below...

Command Line Options

You can specify the following options when running the server:

• --sse: Enable Server-Sent Events transport (on/off)
• --host: Server bind address (default: localhost)
• --port: Server port number (default: 8000)
• --log-level: Logging verbosity (debug, info, warning, error)

📄 License

MIT License