Emlog MCP 服务器

基于 Model Context Protocol (MCP) 的 Emlog 博客系统集成服务，允许 AI 助手通过标准化接口与 Emlog 博客进行交互。

特性

资源

• 博客文章 (emlog://articles) - 获取所有博客文章列表
• 分类 (emlog://categories) - 获取所有分类信息
• 评论 (emlog://comments) - 获取评论列表（基于最新文章）
• 微笔记 (emlog://notes) - 获取微笔记列表
• 草稿文章 (emlog://drafts) - 获取所有草稿文章列表
• 用户信息 (emlog://user) - 获取当前用户信息

工具

• create_article - 创建新博客文章
• update_article - 更新现有博客文章
• get_article - 获取特定文章详情
• search_articles - 搜索文章（支持关键词、标签、分类过滤）
• like_article - 点赞文章
• add_comment - 添加评论
• get_comments - 获取特定文章的评论列表
• create_note - 创建微笔记
• upload_file - 上传文件（图片和其他媒体资源）
• get_user_info - 获取用户信息
• get_draft_list - 获取草稿文章列表
• get_draft_detail - 获取特定草稿的详细信息

技术栈

• TypeScript - 类型安全的 JavaScript 超集
• Node.js - JavaScript 运行时环境
• MCP SDK - Model Context Protocol TypeScript SDK
• Axios - HTTP 客户端库
• Zod - 以 TypeScript 为主的模式验证库
• form-data - 多部分表单数据处理

安装和配置

方法 1：直接使用（推荐）

在 Claude Desktop 配置中直接使用 emlog-mcp，无需本地安装。跳转到 MCP 客户端配置 部分。

方法 2：本地开发安装

1. 克隆项目

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

2. 安装依赖

bash
npm install

3. 环境变量配置

复制示例配置文件并编辑：

bash
cp .env.example .env

在 .env 文件中设置以下环境变量：

bash

Emlog API 基础 URL（必需）

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

Emlog API 密钥（必需）

EMLOG_API_KEY=your_api_key_here

获取 API 密钥：

1. 登录您的 Emlog 后台管理系统
2. 进入“设置”→“API 接口”
3. 启用 API 功能并生成 API 密钥
4. 将生成的密钥复制到 .env 文件中

4. 构建项目

bash
npm run build

5. 运行服务

bash
npm start

或开发模式：

bash
npm run dev

MCP 客户端配置

Claude Desktop 配置

添加到 Claude Desktop 配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

注意： 此配置现在直接使用已发布的 npm 包 emlog-mcp，无需本地安装或编译。npx 会自动下载并运行最新版本。该项目还提供了一个示例配置文件 claude-desktop-config.json 供参考。

其他MCP客户端

对于其他支持MCP的客户端，请参阅各自的文档以获取关于stdio传输配置的信息。

API接口文档

该服务基于Emlog的REST API构建，支持以下主要操作：

文章管理

• GET /api/article_list - 获取文章列表
• GET /api/article_view - 获取特定文章详情
• POST /api/article_save - 创建/更新文章
• POST /api/article_like - 点赞文章

草稿管理

• GET /api/draft_list - 获取草稿列表
• GET /api/draft_detail - 获取特定草稿详情

分类管理

• GET /api/sort_list - 获取分类列表

评论管理

• GET /api/comment_list - 获取评论列表
• POST /api/comment_save - 发表评论

微笔记

• GET /api/note_list - 获取微笔记列表
• POST /api/note_save - 发布微笔记

文件上传

• POST /api/upload - 上传文件

用户管理

• GET /api/userinfo - 获取用户信息

使用示例

创建博客文章

typescript
// 通过MCP工具调用
{
"name": "create_article",
"arguments": {
"title": "我的新文章",
"content": "这是文章内容，支持HTML和Markdown格式。",
"sort_id": 1,
"tag": "技术,编程,MCP",
"is_private": "n",
"allow_comment": "y"
}
}

搜索文章

typescript
// 搜索包含关键词的文章
{
"name": "search_articles",
"arguments": {
"keyword": "技术",
"page": 1,
"count": 10
}
}

获取文章列表

typescript
// 通过MCP资源访问
{
"uri": "emlog://articles"
}

获取草稿列表

typescript
// 获取草稿列表
{
"name": "get_draft_list",
"arguments": {
"count": 10
}
}

获取草稿详情

typescript
// 获取特定草稿的详细信息
{
"name": "get_draft_detail",
"arguments": {
"id": 123
}
}

上传文件

typescript
// 上传图片文件
{
"name": "upload_file",
"arguments": {
"file_path": "/path/to/image.jpg"
}
}

创建微笔记

typescript
// 发布微笔记
{
"name": "create_note",
"arguments": {
"content": "这是一个微笔记",
"is_private": false
}
}

错误处理

该服务包括全面的错误处理机制：

• 网络错误 - 自动重试和超时处理
• API错误 - 返回详细的错误信息
• 认证错误 - 提示API密钥验证失败
• 参数错误 - 输入参数验证及提示

开发与调试

可用脚本

bash

构建项目

npm run build

启动服务

npm start

开发模式（自动重启）

npm run dev

监视模式（自动编译）

npm run watch

运行测试

npm test

日志输出

服务将运行时状态信息输出到stderr以便调试：

bash
Emlog MCP server running on stdio

测试服务

项目中包含一个简单的测试脚本 test-server.js 用于验证服务是否正常工作：

bash
node test-server.js

安全注意事项

1. API密钥保护 - 确保API密钥不被泄露，使用环境变量存储
2. HTTPS连接 - 建议在生产环境中使用HTTPS连接到Emlog API
3. 权限控制 - 确保API密钥具有适当的权限范围
4. 输入验证 - 所有用户输入均经过验证和清理

故障排除

常见问题

1. 连接失败

   • 检查EMLOG_API_URL是否正确
   • 确认Emlog站点可访问

2. 认证失败

   • 验证EMLOG_API_KEY是否有效
   • 检查API密钥权限

3. 工具调用失败

   • 根据错误消息检查具体原因
   • 确认参数格式正确

项目结构

emlog-mcp/
├── src/ # 源代码目录
│ ├── index.ts # MCP服务主入口
│ └── emlog-client.ts # Emlog API客户端
├── dist/ # 编译输出目录
├── docs/ # 文档目录
│ └── api_doc.md # 详细的Emlog API文档
├── .env.example # 环境变量示例文件
├── .gitignore # Git忽略文件配置
├── claude-desktop-config.json # Claude Desktop配置示例
├── test-server.js # 测试脚本
├── package.json # 项目配置和依赖
├── tsconfig.json # TypeScript配置
└── README.md # 项目文档## 贡献

欢迎提交 Issues 和 Pull Requests 来改进此项目。在提交代码之前，请确保：

1. 代码通过 TypeScript 编译检查
2. 遵循项目代码风格
3. 添加适当的错误处理
4. 更新相关文档

许可证

MIT 许可证

相关链接

• 项目仓库
• 模型上下文协议
• MCP TypeScript SDK
• Emlog 官方网站
• Emlog API 文档