🌐 DocuMind MCP 服务器
“当文档遇见数字智能”
下一代模型上下文协议 (MCP) 服务器通过先进的神经处理彻底改变了文档质量分析。
⚡ 核心系统
- 🧠神经文档分析：用于全面评估 README 的高级算法
- 🔮全息标题扫描：用于视觉元素的尖端 SVG 分析
- 🌍多维语言支持：跨语言文档验证
- 💫量子建议引擎：人工智能驱动的改进建议
🚀 系统启动顺序
系统要求
初始化核心
编译矩阵
神经发育链接
建立实时神经连接：
🛸 操作协议
系统配置
与 Claude Desktop 主机集成：
Windows 终端：
// %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"documind-mcp-server": {
"command": "/path/to/documind-mcp-server/build/index.js"
}
}
}
神经接口命令
评估自述文件
启动文档结构的量子分析。
参数：
示例请求：
{
name: "evaluate_readme",
arguments: {
projectPath: "/path/to/project"
}
}
响应示例：
{
content: [
{
type: "text",
text: JSON.stringify({
filePath: "/path/to/project/README.md",
hasHeaderImage: true,
headerImageQuality: {
hasGradient: true,
hasAnimation: true,
// ... other quality metrics
},
score: 95,
suggestions: [
"Consider adding language badges",
// ... other suggestions
]
})
}
]
}
🔮 发展矩阵
调试协议
通过 MCP Inspector 访问神经网络：
故障排除指南
常见问题和解决方案
- 未检测到标题图像
- 确保 SVG 文件放置在
assets/目录中 - 验证 SVG 文件是否包含正确的 XML 结构
- 检查文件权限
- 语言标记无法识别
- 验证徽章使用 shields.io 格式
- 检查 HTML 结构是否遵循推荐的模式
- 确保正确的中心对齐
- 构建错误
- 清除
node_modules并重新安装依赖项 - 确保 TypeScript 版本符合项目要求
- 检查修改后的文件中的语法错误
- MCP 连接问题
- 验证 stdio 传输配置
- 检查 Claude Desktop 配置
- 确保配置中的文件路径正确
性能优化
- SVG分析
- 最小化 SVG 复杂性以实现更快的解析
- 使用高效的渐变和动画
- 优化文件大小同时保持质量
- 自述文件扫描
- 结构内容以实现最佳解析
- 使用推荐的 Markdown 模式
- 遵循徽章放置指南
🔬 API 文档
核心课程
自述服务
主要服务为README的分析与评估。
class ReadmeService {
// Analyzes all README files in a project
async evaluateAllReadmes(projectPath: string): Promise<ReadmeEvaluation[]>
// Evaluates a single README file
private async evaluateReadme(dirPath: string, readmePath: string): Promise<ReadmeEvaluation>
// Evaluates language badge configuration
private evaluateLanguageBadges(content: string): BadgeEvaluation
}
SVG服务
专门针对 SVG 标题图像分析的服务。
class SVGService {
// Evaluates SVG header image quality
public evaluateHeaderImageQuality(imgSrc: string, content: string): HeaderImageQuality
// Checks for project-specific elements in SVG
private checkProjectSpecificImage(svgContent: string, readmeContent: string): boolean
}
核心接口
interface ReadmeEvaluation {
filePath: string;
hasHeaderImage: boolean;
headerImageQuality: HeaderImageQuality;
isCentered: {
headerImage: boolean;
title: boolean;
badges: boolean;
};
hasBadges: {
english: boolean;
japanese: boolean;
isCentered: boolean;
hasCorrectFormat: boolean;
};
score: number;
suggestions: string[];
}
interface HeaderImageQuality {
hasGradient: boolean;
hasAnimation: boolean;
hasRoundedCorners: boolean;
hasEnglishText: boolean;
isProjectSpecific: boolean;
}
错误处理
服务器实现了全面的错误处理：
try {
const evaluations = await readmeService.evaluateAllReadmes(projectPath);
// Process results
} catch (error) {
const errorMessage = error instanceof Error ? error.message : String(error);
return {
content: [{
type: 'text',
text: `Evaluation error: ${errorMessage}`
}],
isError: true
};
}
⚡ 许可证
根据 MIT 协议运行。