mirror of
https://github.com/wassname/HumanAgent-MCP.git
synced 2026-09-09 11:14:27 +08:00
65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# HumanAgent MCP
|
|
|
|
VS Code extension that creates an MCP server for AI assistants to chat with humans.
|
|
|
|
## What it does
|
|
|
|
This extension provides a `HumanAgent_Chat` MCP tool that forces AI assistants to communicate through a human agent instead of giving direct responses. When an AI uses this tool, it opens a chat session where humans can respond in real-time.
|
|
|
|
## How it works
|
|
|
|
- Extension starts MCP server on port 3737
|
|
- Registers `HumanAgent_Chat` tool with VS Code MCP system
|
|
- AI assistants must use this tool for all interactions
|
|
- Creates persistent chat sessions with message history
|
|
- Provides VS Code webview and browser interfaces for human responses
|
|
|
|
## Installation and Setup
|
|
|
|
1. Install the extension in VS Code
|
|
2. Extension activates automatically on startup
|
|
3. MCP server starts and registers with VS Code
|
|
4. Tool becomes available to AI assistants immediately
|
|
|
|
## Chat Interfaces
|
|
|
|
**VS Code Panel**: Dockable chat interface within VS Code
|
|
**Browser Interface**: Available at `http://localhost:3737/HumanAgent`
|
|
|
|
Both interfaces show the same chat sessions and message history.
|
|
|
|
## Tool Customization
|
|
|
|
Create `.vscode/HumanAgentOverride.json` to customize tool descriptions and message behavior:
|
|
|
|
```json
|
|
{
|
|
"version": "1.0.0",
|
|
"description": "Override file for workspace tool configurations",
|
|
"tools": {
|
|
"HumanAgent_Chat": {
|
|
"name": "HumanAgent_Chat",
|
|
"description": "Your custom description here"
|
|
}
|
|
},
|
|
"messageSettings": {
|
|
"global": {
|
|
"autoAppendEnabled": false,
|
|
"autoAppendText": ""
|
|
},
|
|
"toolSpecific": {
|
|
"HumanAgent_Chat": {
|
|
"autoAppendEnabled": true,
|
|
"autoAppendText": "No need to confirm this next part - Remember allways to reply here in this tool unless user suggests otherwise"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Changes require VS Code restart to take effect.
|
|
|
|
## Requirements
|
|
|
|
VS Code version 1.105.0 or higher with native MCP support.
|