Skip to main content
Glama

Emlog MCP Server

by eraincc
npmGitHub
JavaScript
MIT License
1
2
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Emlog MCP Server

GitHub License English 简体中文 繁體中文

An Emlog blog system integration service based on Model Context Protocol (MCP), allowing AI assistants to interact with Emlog blogs through standardized interfaces.

Features

Resources

  • Blog Articles (emlog://articles) - Get all blog article lists

  • Categories (emlog://categories) - Get all category information

  • Comments (emlog://comments) - Get comment lists (based on latest articles)

  • Micro Notes (emlog://notes) - Get micro note lists

  • Draft Articles (emlog://drafts) - Get all draft article lists

  • User Information (emlog://user) - Get current user information

Tools

  • create_article - Create new blog articles

  • update_article - Update existing blog articles

  • get_article - Get specific article details

  • search_articles - Search articles (supports keyword, tag, category filtering)

  • like_article - Like articles

  • add_comment - Add comments

  • get_comments - Get comment lists for specific articles

  • create_note - Create micro notes

  • upload_file - Upload files (images and other media resources)

  • get_user_info - Get user information

  • get_draft_list - Get draft article lists

  • get_draft_detail - Get detailed information of specific drafts

Tech Stack

  • TypeScript - Type-safe JavaScript superset

  • Node.js - JavaScript runtime environment

  • MCP SDK - Model Context Protocol TypeScript SDK

  • Axios - HTTP client library

  • Zod - TypeScript-first schema validation library

  • form-data - Multipart form data processing

Installation and Configuration

Method 1: Direct Use (Recommended)

Use emlog-mcp directly in Claude Desktop configuration without local installation. Jump to MCP Client Configuration section.

Method 2: Local Development Installation

1. Clone the Project

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

2. Install Dependencies

npm install

3. Environment Variable Configuration

Copy the example configuration file and edit:

cp .env.example .env

Set the following environment variables in the .env file:

# Emlog API base URL (required) EMLOG_API_URL=https://your-emlog-site.com # Emlog API key (required) EMLOG_API_KEY=your_api_key_here

Getting API Key:

  1. Log in to your Emlog backend management system

  2. Go to "Settings" → "API Interface"

  3. Enable API functionality and generate API key

  4. Copy the generated key to the .env file

4. Build Project

npm run build

5. Run Service

npm start

Or development mode:

npm run dev

MCP Client Configuration

Claude Desktop Configuration

Add to Claude Desktop configuration file (usually located at ~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "emlog": { "command": "npx", "args": ["emlog-mcp"], "env": { "EMLOG_API_URL": "https://your-emlog-site.com", "EMLOG_API_KEY": "your_api_key_here" } } } }

Note: The configuration now directly uses the published npm package emlog-mcp, no local installation or compilation required. npx will automatically download and run the latest version.

The project also provides an example configuration file claude-desktop-config.json for reference.

Other MCP Clients

For other MCP-supporting clients, please refer to their respective documentation for stdio transport configuration.

API Interface Documentation

This service is built on Emlog's REST API, supporting the following main operations:

Article Management

  • GET /api/article_list - Get article lists

  • GET /api/article_view - Get specific article details

  • POST /api/article_save - Create/update articles

  • POST /api/article_like - Like articles

Draft Management

  • GET /api/draft_list - Get draft lists

  • GET /api/draft_detail - Get specific draft details

Category Management

  • GET /api/sort_list - Get category lists

Comment Management

  • GET /api/comment_list - Get comment lists

  • POST /api/comment_save - Publish comments

Micro Notes

  • GET /api/note_list - Get micro note lists

  • POST /api/note_save - Publish micro notes

File Upload

  • POST /api/upload - Upload files

User Management

  • GET /api/userinfo - Get user information

Usage Examples

Create Blog Article

// Through MCP tool call { "name": "create_article", "arguments": { "title": "My New Article", "content": "This is the article content, supporting HTML and Markdown formats.", "sort_id": 1, "tag": "technology,programming,MCP", "is_private": "n", "allow_comment": "y" } }

Search Articles

// Search articles containing keywords { "name": "search_articles", "arguments": { "keyword": "technology", "page": 1, "count": 10 } }

Get Article List

// Through MCP resource access { "uri": "emlog://articles" }

Get Draft List

// Get draft list { "name": "get_draft_list", "arguments": { "count": 10 } }

Get Draft Details

// Get detailed information of specific draft { "name": "get_draft_detail", "arguments": { "id": 123 } }

Upload File

// Upload image file { "name": "upload_file", "arguments": { "file_path": "/path/to/image.jpg" } }

Create Micro Note

// Publish micro note { "name": "create_note", "arguments": { "content": "This is a micro note", "is_private": false } }

Error Handling

The service includes comprehensive error handling mechanisms:

  • Network Errors - Automatic retry and timeout handling

  • API Errors - Detailed error information return

  • Authentication Errors - API key validation failure prompts

  • Parameter Errors - Input parameter validation and prompts

Development and Debugging

Available Scripts

# Build project npm run build # Start service npm start # Development mode (auto restart) npm run dev # Watch mode (auto compile) npm run watch # Run tests npm test

Log Output

The service outputs runtime status information to stderr for debugging:

Emlog MCP server running on stdio

Test Service

The project includes a simple test script test-server.js to verify if the service is working properly:

node test-server.js

Security Considerations

  1. API Key Protection - Ensure API keys are not leaked, use environment variables for storage

  2. HTTPS Connection - Recommend using HTTPS connection to Emlog API in production

  3. Permission Control - Ensure API keys have appropriate permission scope

  4. Input Validation - All user inputs are validated and sanitized

Troubleshooting

Common Issues

  1. Connection Failure

    • Check if EMLOG_API_URL is correct

    • Confirm Emlog site is accessible

  2. Authentication Failure

    • Verify if EMLOG_API_KEY is valid

    • Check API key permissions

  3. Tool Call Failure

    • Check specific reasons in error messages

    • Confirm parameter format is correct

Project Structure

emlog-mcp/ ├── src/ # Source code directory │ ├── index.ts # MCP service main entry │ └── emlog-client.ts # Emlog API client ├── dist/ # Compiled output directory ├── docs/ # Documentation directory │ └── api_doc.md # Detailed Emlog API documentation ├── .env.example # Environment variable example file ├── .gitignore # Git ignore file configuration ├── claude-desktop-config.json # Claude Desktop configuration example ├── test-server.js # Test script ├── package.json # Project configuration and dependencies ├── tsconfig.json # TypeScript configuration └── README.md # Project documentation

Contributing

Welcome to submit Issues and Pull Requests to improve this project. Before submitting code, please ensure:

  1. Code passes TypeScript compilation checks

  2. Follows project code style

  3. Adds appropriate error handling

  4. Updates relevant documentation

License

MIT License

Related Links

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables AI assistants to interact with Emlog blog systems through a standardized Model Context Protocol interface, supporting content management operations like creating/updating articles, managing comments, uploading files, and accessing blog resources.

  1. Features
    1. Resources
    2. Tools
  2. Tech Stack
    1. Installation and Configuration
      1. Method 1: Direct Use (Recommended)
      2. Method 2: Local Development Installation
    2. MCP Client Configuration
      1. Claude Desktop Configuration
      2. Other MCP Clients
    3. API Interface Documentation
      1. Article Management
      2. Draft Management
      3. Category Management
      4. Comment Management
      5. Micro Notes
      6. File Upload
      7. User Management
    4. Usage Examples
      1. Create Blog Article
      2. Search Articles
      3. Get Article List
      4. Get Draft List
      5. Get Draft Details
      6. Upload File
      7. Create Micro Note
    5. Error Handling
      1. Development and Debugging
        1. Available Scripts
        2. Log Output
        3. Test Service
      2. Security Considerations
        1. Troubleshooting
          1. Common Issues
        2. Project Structure
          1. Contributing
            1. License
              1. Related Links

                Related Resources

                Related MCP Servers

                • Meilisearch MCP Server

                  devlimelabs
                  A
                  security
                  -
                  license
                  A
                  quality
                  Enables AI assistants to interact with Meilisearch via the Model Context Protocol, allowing comprehensive index, document, and search management through a standardized interface.
                  Last updated -
                  68
                  0
                  9
                  MIT License
                  • Apple
                  • Linux

                • n8n MCP Server

                  leonardsellem
                  -
                  security
                  -
                  license
                  -
                  quality
                  A Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.
                  Last updated -
                  133
                  1,377
                  MIT License
                  • Apple
                  • Linux

                • MCP Toolkit

                  zxfgds
                  -
                  security
                  -
                  license
                  -
                  quality
                  A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                  Last updated -
                  36
                  1

                • Omi MCP Server

                  fourcolors
                  A
                  security
                  -
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants to interact with the Omi API for retrieving and creating conversations and memories for users.
                  Last updated -
                  4
                  3

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/eraincc/emlog-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server