emlog

Emlog MCP Server provides a standardized interface to interact with an Emlog blog system through MCP. It exposes resources such as articles, categories, comments, micro notes, drafts, and user information, and a robust set of tools for managing content and interactions: create_article, update_article, get_article, search_articles, like_article, add_comment, get_comments, create_note, upload_file, get_user_info, get_draft_list, and get_draft_detail. Clients can access these capabilities via emlog:// resources or by invoking the tool calls described in the MCP protocol, enabling AI assistants to retrieve data or perform actions against the Emlog backend in a structured way. The server is built with TypeScript and Node.js, leveraging MCP SDK and Axios for HTTP interactions, with environment-based configuration for secure access to the Emlog API.

Prerequisites:

• Node.js (recommended LTS) installed on your system
• Git installed
• Access to the internet to fetch dependencies

Installation steps:

1. Clone the repository (or install via npm if using the published package):

git clone https://github.com/eraincc/emlog-mcp.git
cd emlog-mcp

2. Install dependencies:

npm install

3. Configure environment variables:

cp .env.example .env

Edit .env with your Emlog API details:

EMLOG_API_URL=https://your-emlog-site.com
EMLOG_API_KEY=your_api_key_here

4. Build the project (optional for development):

npm run build

5. Run the service:

npm start

For development:

npm run dev

If you prefer using the published MCP package directly in Claude Desktop, skip local install steps and rely on npx as shown in the MCP client configuration.

Tips and common considerations:

• Ensure EMLOG_API_URL uses the correct base URL for your Emlog instance and that API access is enabled.
• Keep EMLOG_API_KEY secure; prefer environment variables over hard-coding.
• When running in production, consider using HTTPS and validating API keys and permissions.
• If you encounter tool call failures, verify parameter formats against the documented MCP usage examples (e.g., create_article, search_articles).
• The MCP server supports both direct resource access via emlog:// and programmatic tool calls; choose the method that best fits your client configuration.
• The npx-based configuration means you don’t need to install dependencies locally for each user; the latest emlog-mcp package will be fetched on demand.