Zenn MCP Server

MCP Server for interacting with Zenn via GitHub API, enabling Claude to create and manage Zenn articles.

Tools

1. zenn_create_article

   • Create a new article on Zenn via GitHub API
   • Required inputs:
     • title (string): The title of the article
     • content (string): The content of the article in Markdown format
   • Optional inputs:
     • type (string, default: "article"): The type of content ("article" or "book")
     • slug (string): Custom URL slug for the article
     • published (boolean, default: false): Whether the article is published
     • topics (array): Array of topic tags (max 5)
     • emoji (string): Emoji for the article
   • Returns: Created file details from GitHub API

2. zenn_list_articles

   • List articles in your Zenn repository
   • Optional inputs:
     • page (number, default: 1): Page number for pagination
     • per_page (number, default: 20): Number of items per page
   • Returns: List of articles with their metadata and frontmatter info

Setup

1. Create a GitHub personal access token:

   • Go to GitHub Settings > Developer settings > Personal access tokens
   • Generate a new token with the repo scope (for private repos) or public_repo scope (for public repos)
   • Save the generated token

2. Prepare your Zenn GitHub repository:

   • Make sure you have a GitHub repo connected to your Zenn account
   • The repository should follow Zenn's structure with an articles directory

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Using Node Directly

{
  "mcpServers": {
    "zenn": {
      "command": "node",
      "args": [
        "/path/to/your/project/dist/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token",
        "GITHUB_USERNAME": "your-github-username",
        "GITHUB_REPO": "your-zenn-repo-name"
      },
      "autoStart": true
    }
  }
}

Using Docker

{
  "mcpServers": {
    "zenn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "GITHUB_USERNAME",
        "-e",
        "GITHUB_REPO",
        "mcp/zenn"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token",
        "GITHUB_USERNAME": "your-github-username",
        "GITHUB_REPO": "your-zenn-repo-name"
      },
      "autoStart": true
    }
  }
}

Troubleshooting

If you encounter permission errors, verify that:

1. Your GitHub token has the correct scopes enabled
2. The token, username, and repo name are correctly specified
3. Your GitHub repository is properly set up for Zenn

Build

To set up and build the project:

# Install dependencies
npm install

# Build the project
npm run build

Docker build:

docker build -t mcp/zenn -f src/zenn/Dockerfile .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.