MCP Ossinsight

🚀 OSSInsightオープンソース情報分析システム - MCPサーバー

OSSInsightをベースに構築されたオープンソース情報分析MCP（Mission Control Plugin）サーバーです。GitHubの個人、組織、およびプロジェクトに対する包括的なデータ洞察と分析機能を提供します。このシステムは、リポジトリレベルのコード依存関係分析、開発行動パターン認識、プロジェクト健全性評価などの核心機能をサポートしています。

✨ 主な機能

1. コード依存関係ネットワーク分析

• 機能説明：OSSInsightの知識ベースを基に、オープンソースプロジェクトのコード依存関係ネットワークを構築し、プロジェクト間の依存関係とバージョン更新状況を表示します。
• 入力パラメータ：
  • project_id（文字列）：対象プロジェクトの一意の識別子
  • dependency_level（オプションの整数）：依存レベルの深さ。デフォルト値は2レベルです。
• 出力結果：
  • 重要な依存項目のリスト
  • 依存関係ネットワークのデータ
  • サプライチェーン攻撃面分析レポート

2. 開発者行動モデリング

• 機能説明：統計学習手法を用いて、開発者のプログラミング習慣とコードスタイルをモデリングし、異常または高リスクな行動パターンを識別します。
• 入力パラメータ：
  • developer_id（文字列）：対象開発者のアカウント情報
  • time_window（オプションの時間範囲）：指定された時間ウィンドウ。デフォルトは直近1年です。
• 出力結果：
  • 開発者の行動特徴ベクトル
  • コーディング習慣分析レポート
  • 行動リスク評点

3. 組織構造最適化提案

• 機能説明：組織内のオープンソースプロジェクトの依存関係とコード品質に基づいて、組織構造の改善提案を提供します。
• 入力パラメータ：
  • organization_name（文字列）：対象組織の名称
  • category（オプションの文字列）：分析カテゴリ（例："dependency", "quality", "activity"）
• 出力結果：
  • 組織構造評価レポート
  • 改善提案のリスト
  • 重要指標の可視化グラフ

🔧 技術詳細

データ取得メカニズム

1. APIデータインターフェイス：OSSInsightが提供するRESTful APIを通じて、プロジェクトと依存関係の情報を取得します。
2. ログファイル解析：プロジェクトのGitリポジトリの履歴コミットログを分析し、開発者の行動データを抽出します。
3. サードパーティデータベース統合：Maven Central、npm registryなどの依存関係リポジトリのデータを統合します。

モデルトレーニングフロー

1. 特徴エンジニアリング：
   • コードスタイルの特徴（関数の複雑さ、命名規則など）を抽出します。
   • 開発頻度と時間分布を分析します。
   • 依存関係の変更履歴を統計します。
2. モデルトレーニング：
   • XGBoostを使用して分類モデルを構築します。
   • K-meansを用いてクラスタリング分析を行います。
3. 評価と最適化：
   • AUC、F1などの指標を用いてモデルの性能を評価します。
   • 交差検証とハイパーパラメータチューニングを行います。

📦 インストール

クイックスタートガイド

環境要件

• オペレーティングシステム：Linux（推奨）またはmacOS
• メモリ：>=4GB
• ストレージ：>=20GBの空き容量
• 言語：Node.js v16以上

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/ossinsight/mcp-server.git
cd mcp-server

2. 依存関係をインストールします：

npm install

3. サービスを起動します：

npm run start

設定説明

核心設定ファイル：config.js

module.exports = {
  api_key: 'your_api_token',
  db_config: {
    host: 'localhost',
    port: 27017,
    name: 'ossinsight'
  },
  log_level: 'info',
  model_version: 'v1.0.0'
}

ログ設定：logging.json

{
  "loggers": {
    "defaultLogger": {
      "level": "info",
      "handlers": ["consoleHandler"],
      "formatter": "%d-%b-%Y %H:%M:%S % levelname % message"
    }
  },
  "handlers": {
    "consoleHandler": {
      "type": "CONSOLE"
    }
  }
}

💻 使用例

基本的な使用法

例1：プロジェクトの依存関係ネットワークを取得する

const mcp = require('mcp-client');
 
mcp.getProjectDependencies('project123', { level: 2 })
  .then(dependencies => {
    console.log(dependencies);
  })
  .catch(err => {
    console.error(err);
  });

例2：開発者の行動を分析する

const mcp = require('mcp-client');
 
mcp.analyzeDeveloperBehavior('dev456', { window: '1y' })
  .then(report => {
    console.log(report);
  })
  .catch(err => {
    console.error(err);
  });

📚 ドキュメント

システムアーキテクチャ図

[ユーザーリクエスト] --> [API Gateway] --> [サービスゲートウェイ]
            ||||            
         [認証]    [ログ分析]
        ||              ||
      [開発者行動]  [プロジェクト依存関係]
     |                |
  [モデルトレーニングモジュール]  [データ処理モジュール]
  
  [結果保存] <--- [分析エンジン]

更新履歴

v1.0.0（2023-10-10）

• 初期バージョンのリリース
• 基本的な依存関係分析と開発者行動分析機能を提供

v1.1.0（2023-10-25）

• 組織構造最適化提案モジュールを追加
• モデルトレーニングの効率を最適化し、分析速度を向上

技術サポート

技術サポートが必要な場合や問題を報告する場合は、プロジェクトのホームページをご訪問ください。 https://github.com/ossinsight/mcp-server