Bckt-Mpc

1 month ago 2

(I can't believe I did a typo on the repo name...)

A Model Context Protocol (MCP) server that formats blog posts for bckt.

It is designed to work with Claude Desktop and other MCP-compatible clients.

📝 Format blog posts with YAML front matter
🔧 Configurable path patterns and text wrapping
🌍 Timezone-aware date handling
📋 Interactive metadata collection
💾 Save posts directly to your blog directory
👀 Preview before saving

brew install vrypan/bckt-mcp/bckt-mcp

Download the latest release for your platform from the releases page.

git clone https://github.com/vrypan/bckt-mcp.git cd bckt-mcp go build -o bckt-mcp main.go

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "bckt": { "command": "/path/to/bckt-mcp" } } }

Or if installed via Homebrew:

{ "mcpServers": { "bckt": { "command": "/opt/homebrew/bin/bckt-mcp" } } }

On first use, run the setup wizard through Claude:

You'll be prompted for:

root_path: Where your blog posts will be saved (e.g., ~/blog)
timezone: Your timezone (e.g., America/New_York, Europe/Athens, UTC)
path_pattern (optional): Template for file paths (default: posts/{yyyy}/{yyyy}-{MM}-{DD}-{slug}/{slug}.md)
wrap_at (optional): Maximum line width for text wrapping (default: 100)

Configuration is saved to ~/.config/bckt-mcp/config.toml.

Interactive setup wizard for first-time configuration.

View or update configuration settings.

Preview the formatted output without saving.

Format the blog post content with metadata.

Save the formatted markdown to the configured path.

Example Workflow with Claude

Setup (first time only):
Format a blog post:

Format this blog post: [paste your content]

Claude will:
- Ask for title, tags, abstract, slug, and language
- Show you a preview
- Ask if you want to save
View configuration:
Update configuration:

update bckt timezone to Europe/London

The generated front matter includes:

title: Post title
slug: URL-friendly slug (auto-generated from title if not provided)
date: Publication date with timezone
tags: Array of tags
abstract: SEO meta description (wrapped to configured width)
lang: Language code (default: en)

Path Pattern Placeholders

{yyyy}: Year (e.g., 2025)
{MM}: Month (e.g., 01)
{DD}: Day (e.g., 07)
{slug}: Post slug

Example: posts/{yyyy}/{yyyy}-{MM}-{DD}-{slug}/{slug}.md generates:

posts/2025/2025-10-07-my-post/my-post.md

Located at ~/.config/bckt-mcp/config.toml:

root_path = "/Users/username/blog" timezone = "Europe/Athens" path_pattern = "posts/{yyyy}/{yyyy}-{MM}-{DD}-{slug}/{slug}.md" [front_matter] required = ["title", "slug", "date", "tags", "abstract", "lang"] [front_matter.defaults] lang = "en" [markdown_rules] wrap_at = 100