Emlog MCP

🚀 Emlog MCP Server

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) - Retrieve all blog article lists.
• Categories (emlog://categories) - Obtain all category information.
• Comments (emlog://comments) - Fetch comment lists (based on latest articles).
• Micro Notes (emlog://notes) - Get micro note lists.
• Draft Articles (emlog://drafts) - Retrieve all draft article lists.
• User Information (emlog://user) - Obtain 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.

🔧 Technical Details

• TypeScript - A type-safe JavaScript superset.
• Node.js - A JavaScript runtime environment.
• MCP SDK - Model Context Protocol TypeScript SDK.
• Axios - An HTTP client library.
• Zod - A 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 the 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. Navigate to "Settings" → "API Interface".
3. Enable API functionality and generate an API key.
4. Copy the generated key to the .env file.

4. Build Project

npm run build

5. Run Service

npm start

Or use development mode:

npm run dev

📚 MCP Client Configuration

Claude Desktop Configuration

Add to the 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, eliminating the need for local installation or compilation. 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, refer to their respective documentation for stdio transport configuration.

📄 API Documentation

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

Article Management

• GET /api/article_list - Retrieve 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 - Retrieve draft lists.
• GET /api/draft_detail - Get specific draft details.

Category Management

• GET /api/sort_list - Obtain category lists.

Comment Management

• GET /api/comment_list - Retrieve 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 - Obtain 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

• Project Repository
• Model Context Protocol
• MCP TypeScript SDK
• Emlog Official Website
• Emlog API Documentation