# MCP Jibun Server
English | [简体中文](README.zh-CN.md)
This is a Model Context Protocol (MCP) server that allows AI Agents to read posts from [Jibun](https://github.com/elecmonkey/jibun) instances. It is also compatible with [Ech0](https://github.com/lin-snow/Ech0) instances.
## Features
Provides the following tools for AI Agents to call:
* `get_jibun_posts`: Get the latest posts from a Jibun (or Ech0) instance. Supports specifying source (`source`), count (`count`), and page number (`page`).
* `list_jibun_sources`: List all configured Jibun (or Ech0) instance sources.
## Development and Deployment
### 1. Local Development and Cloudflare Workers
We use `wrangler` for local development and Cloudflare deployment.
**Configuration**:
Configure environment variables in the `vars` field of the `wrangler.jsonc` file:
```jsonc
// wrangler.jsonc
{
"vars": {
"JIBUN_INSTANCES": "[{\"name\":\"...\",\"url\":\"...\"}]"
}
}
```
**Common Commands**:
* **Start local server**:
```bash
pnpm dev
```
* **Deploy to Cloudflare**:
```bash
pnpm run deploy
```
### 2. Deploy to Vercel / Netlify
This project is based on the Hono framework and can automatically adapt to Vercel and Netlify runtime environments. It can be deployed with one click by connecting to a Git repository, but please note to configure the correct environment variable in the management panel: `JIBUN_INSTANCES`.
**Format**: A JSON string containing a list of Jibun instances.
**Example**:
```json
[
{"name": "E.m. じぶん", "url": "https://jibun.elecmonkey.com"},
{"name": "River's Lighthouse", "url": "https://river177.com"}
]
```
## Client Configuration
MCP Server URL:
* Cloudflare: `https://<your-worker-subdomain>.workers.dev`
* Vercel: `https://<your-project>.vercel.app`
* Netlify: `https://<your-site>.netlify.app`
Supports `/` or `/mcp` paths.
