Quantitativeresearch

🚀 定量研究 MCP サーバー使用説明

この MCP サーバーは定量研究の研究者向けに設計されており、以下のような重要な機能を提供します。

• 複数の研究セッションにまたがる分析と結果を追跡し、分析の連続性を維持します。
• 仮説とそれを支持する統計テストおよび結果を関連付け、統計的な証拠を整理します。
• 変数間の相関性、予測性、または影響性を記録します。
• 統計モデルの進化とその性能を文書化し、モデル開発を追跡します。
• 統計的な発見を研究問題や理論的枠組みと結びつけ、結果の解釈を支援します。
• 方法論的な決定と分析方法を文書化し、方法論の厳密性を確保します。
• 研究結果を支持するための統計的証拠を整理し、研究報告書の作成を支援します。
• 研究のライフサイクル全体でのエンティティの状態を追跡し、研究の進捗を管理します。
• 高優先度の研究活動を特定し、それに集中するために研究タスクの優先順位付けを行います。
• 研究と分析の手順の論理的な順序を計画し、可視化します。

🚀 クイックスタート

📦 インストール

Claude Desktopを使用する場合

claude_desktop_config.jsonに以下の内容を追加します。

GitHubからインストールし、npxで実行する場合

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "npx",
      "args": [
        "-y",
        "github:tejpalvirk/quantitativeresearch"
      ]
    }
  }
}

グローバルにインストールして直接実行する場合

まず、パッケージをグローバルにインストールします。

npm install -g github:tejpalvirk/quantitativeresearch

次に、Claude Desktopを設定します。

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "contextmanager-quantitativeresearch"
    }
  }
}

Dockerを使用する場合

{
  "mcpServers": {
    "quantitativeresearch": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/quantitativeresearch"
      ]
    }
  }
}

ソースコードからビルドする場合

# リポジトリをクローンする
git clone https://github.com/tejpalvirk/contextmanager.git
cd contextmanager

# 依存関係をインストールする
npm install

# サーバーをビルドする
npm run build

# サーバーを実行する
cd quantitativeresearch
node quantitativeresearch_index.js

Dockerでビルドする場合

docker build -t mcp/quantitativeresearch -f quantitativeresearch/Dockerfile .

📄 ライセンス

このMCPサーバーはMITライセンスの下で公開されています。これは、あなたが自由にソフトウェアを使用、変更、配布することができることを意味しますが、MITライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。

環境変数

定量研究MCPサーバーは、データの保存場所をカスタマイズするために以下の環境変数をサポートしています。

例：

# データを現在の場所に保存する
MEMORY_FILE_PATH="./quantitative-memory.json" SESSIONS_FILE_PATH="./quantitative-sessions.json" 

# 絶対パスでデータの保存場所を指定する
MEMORY_FILE_PATH="/path/to/memory.json" SESSIONS_FILE_PATH="/path/to/sessions.json"

# 現在の作業ディレクトリを基準とした相対パスを使用する
MEMORY_FILE_PATH="relative/path/to/memory.json" SESSIONS_FILE_PATH="relative/path/to/sessions.json"

💻 使用例

基本的な使用法

# ヘルプ情報を表示する
quantitativeresearch --help

# バージョン番号を表示する
quantitativeresearch --version

# サーバーを起動する
quantitativeresearch start [--port PORT]

# サーバーを停止する
quantitativeresearch stop

# サーバーを再起動する
quantitativeresearch restart

高度な使用法

データの保存

# 単一のデータポイントを保存する
quantitativeresearch store <key> <value>

# データを一括保存する
quantitativeresearch store-batch <key1>=<value1>,<key2>=<value2>...

# データの値を取得する
quantitativeresearch get <key>

# データのエントリを削除する
quantitativeresearch delete <key>

データ分析

# 基本的な統計計算を実行する
quantitativeresearch analyze stats [--mean] [--median] [--stddev]

# データレポートを生成する
quantitativeresearch report generate [--summary] [--detailed]

データ可視化

# グラフを生成する
quantitativeresearch visualize plot <key> [--chart-type LINE/BAR/PIE]

# グラフを表示する
quantitativeresearch visualize show <key>

具体的な使用例

# データを保存する
quantitativeresearch store age=30 name=Alice
quantitativeresearch store-batch height=170,weight=60,BMI=21.5

# 分析結果を取得して表示する
quantitativeresearch analyze stats --mean
quantitativeresearch report generate --summary

# データを可視化する
quantitativeresearch visualize plot age --chart-type LINE
quantitativeresearch visualize show height

🔧 技術詳細

エラー処理

よくある問題

• ポートが使用中: デフォルトのポート（3000）が他のプログラムによって使用されている場合、サーバーを起動できません。そのポートが使用されていないことを確認するか、起動時に別のポートを指定してください。

quantitativeresearch start --port 3001

• データ形式のエラー: データを保存する際に、キーと値のペアの形式が正しくない場合、エラーが発生します。キーと値の間を等号で区切り、余分な空白を入れないようにしてください。

# 誤った例
quantitativeresearch store key= value エラー

# 正しい例
quantitativeresearch store key=value

• データが見つからない: 存在しないキーを取得または削除しようとすると、エラーメッセージが返されます。

quantitativeresearch get non_existent_key
# 出力: エラー：指定されたキー 'non_existent_key' は存在しません

安全な終了とデバッグ

安全な終了

サーバーを安全に閉じるには、stop コマンドを使用してください。

quantitativeresearch stop

これにより、すべての未処理の操作が適切に処理され、すべてのリソースが解放されます。

デバッグモード

問題が発生した場合、デバッグモードを有効にして詳細な情報を取得することができます。

quantitativeresearch --debug start

これにより、コンソールに詳細なデバッグ情報が出力され、潜在的な問題の診断に役立ちます。