{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_y7v247cu32uk","handle":"iflow-mcp-upamune-human-mcp","url":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp","links":{"self":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp/record.json","html":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp","markdown":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-upamune-human-mcp","status":"https://wellknown.network/api/v1/agents/iflow-mcp-upamune-human-mcp/status","claim":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-upamune-human-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-upamune-human-mcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-upamune-human-mcp/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-upamune-human-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_upamune-human-mcp","summary":"A joke MCP server powered by a real human via Streamlit UI.","description":"# human-mcp\n\n人間をMCPツールとして提供するMCPサーバー\n\n![demo](.github/assets/demo.gif)\n\n## 概要\n\n![image](.github/assets/arch.jpg)\n\nhuman-mcpは、AIアシスタントが人間の能力を活用できるようにするMCPサーバーです。AIアシスタントからのリクエストを受け取り、人間に指示を表示し、人間からの応答をAIアシスタントに返します。\n\n主な機能：\n- MCPクライアントからのツール実行リクエスト (STDIN経由) を受け付ける\n- 実行に必要な指示をSQLiteデータベースに書き込む\n- StreamlitアプリケーションがSQLiteを監視し、人間に指示を表示、応答入力を促す\n- 人間がStreamlit経由で入力した結果をSQLiteに書き込む\n- MCPサーバーがSQLiteから結果を読み取り、MCPレスポンスとしてクライアント (STDOUT経由) に返す\n\n## 提供するツール\n\n1. **human_eye_tool**: 人間が目で見て状況を説明したり、特定のものを探したりします。\n2. **human_hand_tool**: 人間が手を使って簡単な物理的操作を実行します。\n3. **human_mouth_tool**: 人間が口を使って指定された言葉を発話します。\n4. **human_weather_tool**: 人間が現在地の天気を確認して報告します。\n5. **human_ear_tool**: 人間が耳を使って音を聞き、状況を説明します。\n6. **human_nose_tool**: 人間が鼻を使って匂いを確認します。\n7. **human_taste_tool**: 人間が口を使って食べ物を味わい、その味を説明します。\n\n## セットアップ\n\n### 前提条件\n\n- Python 3.12以上\n- uv\n- SQLite3\n\n### インストール手順\n\n1. リポジトリをクローン\n   ```bash\n   git clone https://github.com/yourusername/human-mcp.git\n   cd human-mcp\n   ```\n\n2. 仮想環境を作成して有効化\n   ```bash\n   uv venv\n   source .venv/bin/activate\n   ```\n\n3. 依存関係をインストール\n   ```bash\n   uv pip install .\n   ```\n\n## 使用方法\n\n0. MCPサーバーをインストール\n  ```bash\n  task install-mcp\n  ```\n\n1. ClaudeからMCPサーバーに接続\n   ```json\n   \"human-mcp\": {\n     \"command\": \"uv\",\n     \"args\": [\n       \"run\",\n       \"--with\",\n       \"mcp[cli]\",\n       \"mcp\",\n       \"run\",\n       \"$PATH_TO_REPOSITORY/human_mcp/mcp_server.py\"\n     ]\n   }\n   ```\n\n3. 2つ目のターミナルでStreamlit UIを起動\n   ```bash\n   task run-streamlit\n   ```\n\n4. ブラウザで表示されるStreamlit UIにアクセス（通常は http://localhost:8501 ）\n\n5. MCPクライアント（例：Claude Desktop）からリクエストを送信すると、Streamlit UIにタスクが表示されます。\n\n6. Streamlit UIで応答を入力し、「応答を送信」ボタンをクリックすると、その応答がMCPクライアントに返されます。\n\n## プロジェクト構造\n\n```\nhuman-mcp/\n├── human_mcp/              # メインのPythonパッケージ\n│   ├── __init__.py         # パッケージマーカー\n│   ├── db_utils.py         # SQLite関連ユーティリティ\n│   ├── tools.py            # ツール定義\n│   ├── mcp_server.py       # MCPサーバー本体\n│   └── streamlit_app.py    # Streamlit UI アプリ\n├── human_tasks.db          # SQLite データベースファイル (実行時に生成)\n…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_upamune-human-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_upamune-human-mcp","registry":"pypi","observedAt":"2026-09-15T20:21:33.335Z","publishedAt":"2026-02-09T01:43:13.341335Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_upamune-human-mcp","url":"https://pypi.org/project/iflow-mcp_upamune-human-mcp/","firstSeenAt":"2026-09-09T21:24:42.694Z","fetchedAt":"2026-09-15T20:20:25.480Z","normalizedAt":"2026-09-15T20:20:25.480Z"}]},"firstSeenAt":"2026-09-09T21:24:42.694Z","updatedAt":"2026-09-15T20:21:33.335Z"}