Sunwood Ai Labs Documind MCP Server

🚀 🌐 DocuMind MCP Server

一款革命性的 Model Context Protocol (MCP) 服務器，通過高級神經處理徹底改變文檔質量分析，是文檔與數字智能的交匯點。

✨ 主要特性

• 🧠 神經文檔分析：採用先進的算法，可對 README 進行全面評估。
• 🔮 全息標題掃描：運用尖端的 SVG 分析技術，處理視覺元素。
• 🌍 多維語言支持：能夠進行跨語言文檔驗證。
• 💫 量子建議引擎：由 AI 驅動，可給出文檔改進建議。

📦 安裝指南

系統要求

• Node.js 18+
• npm || yarn

初始化核心

npm install

編譯矩陣

npm run build

神經開發鏈接

建立即時神經連接：

npm run watch

💻 使用示例

基礎用法

系統配置

與 Claude Desktop 主機集成：

Windows 終端:

// %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "documind-mcp-server": {
      "command": "/path/to/documind-mcp-server/build/index.js"
    }
  }
}

神經接口命令 - evaluate_readme

啟動量子分析文檔結構。

參數：

• projectPath: 神經通路到目標目錄

示例請求：

{
  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,
          // 其他質量指標...
        },
        score: 95,
        suggestions: [
          "考慮添加語言徽章",
          // 其他建議...
        ]
      })
    }
  ]
}

🔧 技術細節

調試協議

通過 MCP 檢查器訪問神經網絡：

npm run inspector

故障排除指南

常見問題和解決方案

1. 標題圖像未檢測到

   • 確保 SVG 文件位於 assets/ 目錄
   • 驗證 SVG 文件包含正確的 XML 結構
   • 檢查文件權限

2. 語言徽章未識別

   • 確認徽章使用 shields.io 格式
   • 檢查 HTML 結構是否符合推薦模式
   • 確保正確居中對齊

3. 構建錯誤

   • 清除 node_modules 並重新安裝依賴項
   • 確保 TypeScript 版本與項目要求匹配
   • 檢查修改文件中的語法錯誤

4. MCP 連接問題

   • 驗證 stdio 傳輸配置
   • 檢查 Claude Desktop 配置
   • 確保配置中正確路徑

性能優化

1. SVG 分析

   • 最小化 SVG 複雜度以加快解析
   • 使用高效漸變和動畫
   • 在保持質量的同時優化文件大小

2. README 掃描

   • 結構內容以實現最佳解析
   • 確保標題圖像、標題和徽章居中

錯誤處理

服務器實現全面的錯誤處理：

try {
  const evaluations = await readmeService.evaluateAllReadmes(projectPath);
  // 處理結果
} catch (error) {
  const errorMessage = error instanceof Error ? error.message : String(error);
  return {
    content: [{
      type: 'text',
      text: `評估錯誤: ${errorMessage}`
    }],
    isError: true
  };
}

📄 許可證

本項目在 MIT 協議下運行。