🌐 DocuMind MCP サーバー

「ドキュメントとデジタルインテリジェンスが出会う場所」

高度なニューラル処理を通じてドキュメント品質分析に革命をもたらす次世代のモデルコンテキストプロトコル (MCP) サーバー。

⚡ コアシステム

🧠ニューラルドキュメント分析：包括的なREADME評価のための高度なアルゴリズム
🔮ホログラフィックヘッダースキャン：視覚要素のための最先端のSVG分析
🌍多次元言語サポート：言語間のドキュメント検証
💫量子提案エンジン：AIを活用した改善提案

Related MCP server: GitHub MCP Server

🚀 システムブートシーケンス

システム要件

Node.js 18歳以上
npm || 糸

コアの初期化

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"
    }
  }
}

神経インターフェースコマンド

評価_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,
          // ... other quality metrics
        },
        score: 95,
        suggestions: [
          "Consider adding language badges",
          // ... other suggestions
        ]
      })
    }
  ]
}

🔮 開発マトリックス

デバッグプロトコル

MCP Inspector を通じてニューラルネットワークにアクセスします。

npm run inspector

トラブルシューティングガイド

よくある問題と解決策

ヘッダー画像が検出されません
- SVGファイルがassets/ディレクトリに配置されていることを確認する
- SVGファイルに適切なXML構造が含まれていることを検証する
- ファイルの権限を確認する
言語バッジが認識されない
- バッジがshields.io形式を使用していることを確認する
- HTML構造が推奨パターンに従っているか確認する
- 適切な中心位置合わせを確保する
ビルドエラー
- node_modulesをクリアして依存関係を再インストールする
- TypeScript のバージョンがプロジェクト要件と一致していることを確認する
- 変更されたファイルの構文エラーをチェックする
MCP 接続の問題
- stdioトランスポート構成を確認する
- Claude Desktopの設定を確認する
- 設定で適切なファイルパスを確認する

パフォーマンスの最適化

SVG分析
- SVGの複雑さを最小限に抑えて解析を高速化する
- 効率的なグラデーションとアニメーションを使用する
- 品質を維持しながらファイルサイズを最適化
READMEスキャン
- 最適な解析のためにコンテンツを構造化する
- 推奨されるマークダウンパターンを使用する
- バッジの配置ガイドラインに従う

🔬 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 プロトコルに従って動作します。

DocuMind MCP Server