STARWARCLOUD STARWAR.AI
返回市场
日志管理器-MCP

日志管理器-MCP

作者：eraincc2 星标更新：2025-06-24
安装使用来源：spider==github.com

项目介绍

Emlog MCP Server

GitHub License English 简体中文 繁體中文

基于模型上下文协议（MCP）集成的Emlog博客系统服务，允许AI助手通过标准化接口与Emlog博客进行交互。

<a href="https://glama.ai/mcp/servers/@eraincc/emlog-mcp"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=4128595613,3458328242&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Emlog MCP Server" /> </a>

功能

资源

  • 博客文章 (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 - 模型上下文协议TypeScript SDK
  • Axios - HTTP客户端库
  • Zod - TypeScript优先的模式验证库
  • form-data - 多部分表单数据处理

安装与配置

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

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

方法2：本地开发安装

1. 克隆项目

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

2. 安装依赖

npm install

3. 环境变量配置

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

cp .env.example .env

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

# 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. 构建项目

npm run build

5. 运行服务

npm start

或开发模式：

npm run dev

MCP客户端配置

Claude Desktop配置

添加到Claude Desktop配置文件（通常位于~/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"
      }
    }
  }
}

注意： 配置现在直接使用已发布的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 - 获取用户信息

使用示例

创建博客文章

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

搜索文章

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

获取文章列表

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

获取草稿列表

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

获取草稿详情

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

上传文件

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

创建微笔记

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

错误处理

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

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

开发与调试

可用脚本

# 构建项目
npm run build

# 启动服务
npm start

# 开发模式（自动重启）
npm run dev

# 监视模式（自动编译）
npm run watch

# 运行测试
npm test

日志输出

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

Emlog MCP服务器正在stdio上运行

测试服务

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

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许可证

相关链接