Human MCP

🚀 human - mcp

人間がMCPツールとして提供するMCPサーバーです。このサーバーはAIアシスタントが人間の能力を活用するためのもので、AIアシスタントからのリクエストを受け取り、人間とのインターフェースで指示を表示し、人間の応答をAIアシスタントに返します。

🚀 クイックスタート

human - mcpは、AIアシスタントが人間の能力を活用できるMCPサーバーです。以下に、その概要を説明します。

human - mcpは、AIアシスタントが人間の能力を活用するためのMCPサーバーです。これはAIアシスタントからのリクエストを受け取り、人間とのインターフェースで指示を表示し、人間の応答をAIアシスタントに返します。

主な機能は以下の通りです。

• MCPクライアントから標準入力を通じて送られるツール実行リクエストを受け取ります。
• 必要な指示をSQLiteデータベースに書き込みます。
• StreamlitアプリケーションがSQLiteデータベースを監視し、人間に指示を表示し、入力を促します。
• Streamlitを通じて人間の入力を受け取り、それをSQLiteデータベースに書き込みます。
• MCPサーバーがデータベースから結果を読み取り、標準出力を通じてMCPクライアントに返します。

✨ 主な機能

提供されるツールは以下の通りです。

1. human_eye_tool：人間の目で環境を観察し、状況を説明するか、特定の物体を探します。
2. human_hand_tool：手動で簡単な物理的操作を実行します。
3. human_mouth_tool：口頭で指示を出すか、指定された単語を発声します。
4. human_weather_tool：現在位置の天気状況を調べて報告します。
5. human_ear_tool：聴覚を使って環境を感知し、聞こえる音を説明します。
6. human_nose_tool：嗅覚を通じて匂いを感知し、嗅いだ匂いを説明します。
7. human_taste_tool：食べ物を味わい、その味を説明します。

📦 インストール

前提条件

• Python 3.12以上
• uvツール
• SQLite3

インストール手順

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

   git clone https://github.com/yourusername/human-mcp.git
   cd human-mcp
   

2. 仮想環境を作成し、アクティブ化します。

   uv venv
   source .venv/bin/activate
   

3. 依存関係をインストールします。

   uv pip install .
   

💻 使用例

基本的な使用法

0. MCPサーバーをインストールします。

task install-mcp

1. ClaudeでMCPサーバーに接続します。

   "human-mcp": {
     "command": "uv",
     "args": [
       "run",
       "--with",
       "mcp[cli]",
       "mcp",
       "run",
       "$PATH_TO_REPOSITORY/human_mcp/mcp_server.py"
     ]
   }
   

2. 別のターミナルでStreamlit UIを起動します。

   task run-streamlit
   

3. ブラウザでStreamlit UIにアクセスします（通常は http://localhost:8501 ）。

4. MCPクライアント（例：Claude Desktop）からリクエストが送信されると、Streamlit UIにタスクが表示されます。

5. Streamlit UIで応答を入力し、「応答を送信」ボタンをクリックすると、その応答がMCPクライアントに返されます。

📚 ドキュメント

プロジェクト構造

human-mcp/
├── human_mcp/          # 主な機能コード
│   ├── tools/         # 各ツールの実装
│   └── ui/           # Streamlitユーザーインターフェース
├── config.py          # 設定ファイル
├── requirements.txt    # 依存関係管理
└── README.md          # プロジェクト説明

📄 ライセンス

[ライセンス情報]

注意事項

このプロジェクトは娯楽およびテスト目的でのみ提供されており、本番環境での使用は推奨されません。