Ask Human MCP

🚀 ask - human mcp 🧑‍💻🤝🤖

このプロジェクトは、AIが誤った情報を出力する問題を解決します。AIが混乱した際に、代わりに人間に質問することで、正しい情報を得られるようにします。

🚀 クイックスタート

このセクションでは、ask - human - mcpのセットアップ方法を説明します。

30秒セットアップ

pip install ask - human - mcp
ask - human - mcp

.cursor/mcp.jsonに以下の設定を追加します。

{
  "mcpServers": {
    "ask - human": { "command": "ask - human - mcp" }
  }
}

Cursorを再起動して、使い始めましょう。

✨ 主な機能

• 簡単なインストール：pip install ask - human - mcpで完了。
• ゼロコンフィグレーション：クロスプラットフォームで即座に使用可能。
• ファイル監視：ファイルを監視し、即座にフィードバックを得られます。
• 複数エージェント対応：複数のAIエージェントを問題なく扱えます。
• ロックと制限：システムが破損しないように制御。
• Q&A履歴の保存：Markdown形式で完全なQ&A履歴を保存（デバッグに便利）。

📦 インストール

ask - human - mcpをインストールするには、以下のコマンドを実行します。

pip install ask - human - mcp

💻 使用例

基本的な使用法

answer = await ask_human(
    "what database should i use for this project?",
    "building a chat app with 1000+ concurrent users"
)

その他のツール

• list_pending_questions()：回答待ちの質問を取得。
• get_qa_stats()：Q&Aセッションの統計情報を取得。

📚 ドキュメント

仕組み

1. AIが困ったときにask_human(question, context)を呼び出します。
2. 質問がask_human.mdに記録され、一意のIDが付与されます。
3. 人間が回答を記入し、"PENDING"を回答で置き換えます。
4. AIは回答を受け取り、コーディングを続行します。

設定オプション

コマンドライン

ask - human - mcp --help
ask - human - mcp --port 3000 --host 0.0.0.0  # http mode
ask - human - mcp --timeout 1800               # 30min timeout  
ask - human - mcp --file custom_qa.md          # custom q&a file
ask - human - mcp --max - pending 50             # max concurrent questions
ask - human - mcp --max - question - length 5000   # max question size
ask - human - mcp --rotation - size 10485760     # rotate file at 10mb

異なるクライアント

Cursor（ローカル）:

{
  "mcpServers": {
    "ask - human": {
      "command": "ask - human - mcp",
      "args": ["--timeout", "900"]
    }
  }
}

Cursor（HTTP）:

{
  "mcpServers": {
    "ask - human": {
      "url": "http://localhost:3000/sse"
    }
  }
}

Claude Desktop:

{
  "mcpServers": {
    "ask - human": {
      "command": "ask - human - mcp"
    }
  }
}

セキュリティ対策

• 入力サニタイズ：制御文字を削除し、サイズを検証。
• ファイルロック：同時アクセスによる破損を防止。
• セキュアなパーミッション：制限付きアクセスでファイルを作成。
• リソース制限：メモリ枯渇やDOS攻撃を防止。
• パス検証：ファイルが安全な場所に書き込まれることを保証。

制限事項

プラットフォームサポート

• Windows：ネイティブファイルロックで完全サポート。
• macOS：fseventsファイル監視で完全サポート。
• Linux：inotifyファイル監視で完全サポート。

🔧 技術詳細

ソースからのビルド

git clone https://github.com/masonyarbrough/ask - human - mcp.git
cd ask - human - mcp
pip install -e ".[dev]"
ask - human - mcp

テスト

pytest tests/ -v

コード品質

black ask_human_mcp tests
ruff check ask_human_mcp tests  
mypy ask_human_mcp

🤝 コントリビューション

コントリビューターを大歓迎します。

問題の報告

GitHubのイシュートラッカーを使用して、バグを報告したり、機能をリクエストしたりできます。また、メールでも連絡できます：mason@kallro.com

報告には以下を含めてください：

• Pythonのバージョン
• オペレーティングシステム
• MCPクライアント（Cursor、Claude Desktopなど）
• エラーメッセージまたはログ
• 再現手順

📜 変更履歴

バージョン履歴については、CHANGELOG.mdを参照してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🙏 謝辞

• model context protocol：優れた標準を提供してくれた。
• anthropic：ClaudeとMCPサポートを提供してくれた。
• cursor：MCP統合を提供してくれた。
• フィードバックを提供してくれたすべてのコントリビューターとユーザー。