安装方案
方案 1: GitHub 直接安装 (最快)
npm install -g "github:easemob/imdev-mcp-server"
或指定分支/tag
npm install -g "github:easemob/imdev-mcp-server#v1.0.0"
方案 2: 手动配置路径 (零发布)
用户克隆repo或者下载源码 git clone https://github.com/easemob/imdev-mcp-server cd imdev-mcp-server/easeim-mcp-server/ && npm install && npm run build
配置 Claude（使用绝对路径）
{
"mcpServers": {
"easeim":{
"command": "node",
"args": ["/Path/imdev-mcp-server/easeim-mcp-server/dist/index.js"],
"env": {
"EASEIM_TRACE_LOG": "true",
"EASEIM_TRACE_LOG_PATH": "/Path/imdev-mcp-server/easeim-mcp-server/tmp/easeim-mcp-server.log",
"EASEIM_SMART_ASSIST_LOG": "1",
"EASEIM_SMART_ASSIST_LOG_PATH": "/Path/imdev-mcp-server/easeim-mcp-server/tmp/smart_assist.log",
"EASEIM_TOOL_LOG": "1",
"EASEIM_TOOL_LOG_PATH": "/Path/imdev-mcp-server/easeim-mcp-server/tmp/tool.log"
}
}
}
}2026-03 关键优化（文档同步）
本仓库的核心实现位于 easeim-mcp-server/，本次优化已同步到对应文档：
- 全平台分片刷新命令：
npm --prefix "easeim-mcp-server" run generate-all-platform-shards - 新增平台覆盖：
flutter、harmony（含平台别名归一） - 查询纠缠证据链分析：支持回放日志并自动输出归因报告
- 平台能力约束回答：对“当前无内容”场景直接说明并附证据
详细说明见：
easeim-mcp-server/README.mdeaseim-mcp-server/docs/TECHNICAL_OVERVIEW.mdeaseim-mcp-server/docs/RAW_MATERIALS_REQUIREMENTS.mdeaseim-mcp-server/docs/QUERY_FRICTION_ANALYSIS.md
功能概览
┌─────────────────────────────────────────────────────────────────┐
│ easeim-mcp-server │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ 搜索引擎层 │ │ 智能化层 │ │ 诊断层 │ │
│ │ │ │ │ │ │ │
│ │ • 文档搜索 │ │ • 意图分类 │ │ • 集成检查 │ │
│ │ • 源码搜索 │ │ • 实体提取 │ │ • 错误诊断 │ │
│ │ • 配置搜索 │ │ • 查询扩展 │ │ • Podfile 检查 │ │
│ │ • 分片搜索 │ │ • 代码生成 │ │ • 检查清单 │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
│ │ │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ 核心算法层 │ │
│ │ │ │
│ │ BM25 评分 • 倒排索引 • LRU 缓存 • 歧义检测 • 上下文感知 │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘MCP 工具列表（19 个）
基础工具（10 个）
| 工具 | 描述 |
|---|---|
lookup_error | 查询错误码含义、原因和解决方案 |
search_api | 搜索 API 文档，支持平台/层级过滤 |
search_source | 搜索 UIKit 源码，支持组件过滤 |
get_guide | 获取集成指南和最佳实践 |
diagnose | 根据症状诊断错误原因 |
read_doc | 读取完整 API 文档 |
read_source | 读取源码文件（支持行范围） |
list_config_options | 列出 Appearance 配置项 |
get_extension_points | 获取可继承类和协议 |
get_config_usage | 查询配置项的使用详情 |
智能化工具（4 个）
| 工具 | 描述 |
|---|---|
smart_assist | 🧠 自然语言智能助手，支持上下文感知，自动理解意图和连续性问题 |
generate_code | 📝 代码生成器，生成完整代码模板 |
explain_class | 📖 类解释器，说明继承关系和用法 |
list_scenarios | 📋 列出所有支持的开发场景 |
集成诊断工具（5 个）
| 工具 | 描述 |
|---|---|
check_integration | 🔍 检查 Podfile 配置是否符合要求 |
diagnose_build_error | 🛠️ 诊断 Xcode 构建错误 |
get_podfile_template | 📄 获取推荐的 Podfile 模板 |
get_integration_checklist | ✅ 获取完整集成检查清单 |
get_platform_requirements | 📋 查询平台版本要求 |
精准度保障
- 最小相关性阈值：低于阈值直接视为未命中
- 歧义强制澄清：平台/层级/组件歧义不直接输出结果
- 证据绑定输出：API 文档路径、源码行号或错误码索引可追溯