Zenn

Provides an MCP endpoint to fetch Zenn articles and books for integration.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shibuiwilliam-mcp-server-zenn": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-zenn",
        "run",
        "mcp-server-zenn"
      ]
    }
  }
}

You host an MCP server that exposes Zenn data via the Model Context Protocol, letting clients fetch articles and books from Zenn through a lightweight local service. This server is designed for easy local development and integration with MCP clients that consume data sources through standard MCP endpoints.

How to use

To use this MCP server locally, run it as a standard MCP endpoint and connect your MCP client to the local process. You can debug and inspect the server flow with the provided inspector tooling. The server exposes functions to fetch a list of articles and a list of books from Zenn through the MCP interface.

Run the MCP server locally using the inspector flow shown here, then connect your client to the resulting MCP endpoint. You can monitor the server activity and debug calls with the inspector URL presented after you start the inspector.

How to install

Prerequisites you need on your machine before starting this server:

Node.js (version 14+ recommended) and npm or yarn for dependency management.
Git to clone the project repository.

Follow these steps to set up and run the MCP server locally:

# 1) Clone the repository
git clone https://github.com/shibuiwilliam/mcp-server-zenn.git

# 2) Navigate into the project directory (adjust path as needed)
cd mcp-server-zenn

# 3) Install dependencies
npm install

# 4) Start the inspector with the MCP server
npx @modelcontextprotocol/inspector uv --directory=src/mcp_server_zenn run mcp-server-zenn

Additional content

You can also configure this server as a standalone MCP server by adding it to your MCP configuration. Use the provided structure to enable the server via a local runtime command, which allows you to run the MCP server in your environment without network calls.

Example configuration to run the server via MCP tooling uses a local runtime command. This shows how you attach the local server entry to your MCP runner.

{
  "zenn": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-server-zenn",
      "run",
      "mcp-server-zenn"
    ]
  }
}

Available tools

listArticles

Fetches the list of articles from Zenn via MCP and exposes the article metadata to MCP clients.

listBooks

Fetches the list of books from Zenn via MCP and exposes the book metadata to MCP clients.