Back to the catalog

BlogCaster MCP

An MCP server for the BlogCaster project.

Open source Repository Open in the app JSON README (API)

About

An MCP server for the BlogCaster project.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
bamacharanchhandogi
Origin
official
Category
ferramentas
Transport
http
Version
1.0.1
Stars
1
Last push
2025-12-20T19:39:03Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:01:42
Updated
2026-09-13 03:11:25
Origin id
io.github.BamaCharanChhandogi/blogcaster-mcp

README

# ๐Ÿš€ BlogCaster MCP โ€” Your Blog Ecosystem, One MCP Server

[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue?logo=github)](https://registry.modelcontextprotocol.io)
[![NPM Version](https://img.shields.io/npm/v/blogcaster-mcp)](https://www.npmjs.com/package/blogcaster-mcp)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

Cloud-hosted MCP server that lets you **publish, list, and delete posts across multiple blogging platforms** from any MCP-enabled client (Claude Desktop, Cursor/Cline, etc.). No local installs โ€” just point your client at the URL.

**Architecture: Secure Session-Based Storage**  
Tokens are stored encrypted in dedicated, ephemeral Durable Objects. Each chat session gets a unique storage box.

---

## ๐Ÿ“ฆ Installation

### Option 1: NPM Package (Recommended)

Install via NPM for local stdio transport:

```bash
npm install -g blogcaster-mcp
```

Then configure your MCP client:

**Claude Desktop:**
```json
{
  "mcpServers": {
    "blogcaster": {
      "command": "npx",
      "args": ["-y", "blogcaster-mcp"]
    }
  }
}
```

**Cursor / Cline:**
```json
{
  "blogcaster": {
    "command": "npx",
    "args": ["-y", "blogcaster-mcp"]
  }
}
```

### Option 2: Remote Cloud Endpoint

Use the hosted Cloudflare Worker (no installation required):

**MCP Endpoint:**
```
https://blogcaster-mcp.rrpb2580.workers.dev/mcp
```

**Claude Desktop:**
```json
{
  "mcpServers": {
    "blogcaster": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://blogcaster-mcp.rrpb2580.workers.dev/mcp"]
    }
  }
}
```

**Cursor / Cline:**
```json
{
  "blogcaster": {
    "url": "https://blogcaster-mcp.rrpb2580.workers.dev/mcp"
  }
}
```

Restart the client after saving the config.

---

## ๐Ÿ› ๏ธ Tools you can call

- `getTokenManagementLink()` โ€” **Start here.** Generates a secure link to manage your tokens.
- `publishPost(title, contentMarkdown, platforms, coverImageURL?)` โ€” publish to one or many blogs.
- `getBlogs(platforms)` โ€” list recent posts per platform.
- `deletePost(platforms, postId)` โ€” delete by ID on one or many platforms.

---

## ๐Ÿšฆ Quickstart flow

### 1) Setup Tokens (Do this once per session)
- Ask AI: *"Give me the link to manage my tokens"*
- Click the link generated by `getTokenManagementLink()`
- Add your platform keys (Hashnode, Dev.to, WordPress) in the secure web portal.

### 2) Publish a post

```javascript
publishPost(
  title: "My First BlogCaster Demo",
  contentMarkdown: "# Hello World\\nPublished via MCP!",
  platforms: ["hashnode", "devto", "wordpress"],
  coverImageURL: "https://example.com/cover.jpg"
)
```

### 3) List posts

```javascript
getBlogs({ platforms: ["hashnode", "devto", "wordpress"] })
```

### 4) Delete a post by ID

```javascript
deletePost({ platforms: ["devto", "wordpress"], postId: "12345" })
```

---

## ๐ŸŒ Platform support

| Platform   | Status | Notes |
|------------|--------|-------|
| Hashnode   | โœ…     | Cover images ignored (API limitation) |
| Dev.to     | โœ…     | Cover image URL supported |
| WordPress  | โœ…     | Supports self-hosted + WordPress.com |
| Medium     | ๐Ÿ”œ     | Planned |

---

## โ“ FAQ

**Do I install anything?**  
No โ€” everything runs on Cloudflare Workers (remote mode) or via NPM (local mode).

**Where are tokens stored?**  
Secure Durable Object storage scoped to your session.

**Does it remember me tomorrow?**  
Sessions are ephemeral. If you start a new chat, you'll need to link again (this is a security feature).

**Can I self-host?**  
Yes, deploy the Worker and point your MCP client to your URL.

**Does BlogCaster store my posts?**  
Only temporarily to publish; no retention.

---

## ๐Ÿ”ง Development

```bash
# Clone the repository
git clone https://github.com/BamaCharanChhandogi/BlogCaster-MCP.git
cd BlogCaster-MCP

# Install dependencies
npm install

# Run locally
npm run dev

# Deploy to Cloudflare Workers
npm run deploy
```

---

## ๐Ÿ“„ License

MIT License - see [LICENSE](LICENSE) for details.

---

## ๐Ÿค Contributing

Contributions are welcome! Please open an issue or submit a pull request.

---

## ๐Ÿ”— Links

- [MCP Registry](https://registry.modelcontextprotocol.io)
- [NPM Package](https://www.npmjs.com/package/blogcaster-mcp)
- [GitHub Repository](https://github.com/BamaCharanChhandogi/BlogCaster-MCP)
- [Model Context Protocol](https://modelcontextprotocol.io)

More