Chat Human MCP Server

# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Project Overview mcp-chat-help is a Model Context Protocol (MCP) server that enables AI agents to send messages to human users via chat and optionally request responses. It uses stdio transport for communication. For example, we envision using it for scenarios like: "Sending a message to users to ask for help when encountering an unsolvable problem during coding" or "Consulting users to make critical decisions." ## Commands ```bash pnpm install # Install dependencies pnpm build # Build (compiles TypeScript to build/ directory) pnpm clean # Remove build artifacts pnpm watch # Development with hot reload pnpm dev # Run with MCP Inspector for debugging pnpm typecheck # Type check without building pnpm lint # Run ESLint pnpm lint:fix # Run ESLint with auto-fix ``` ## Architecture - **src/index.ts** - Entry point; initializes the MCP server with stdio transport - **src/server.ts** - Server factory; registers the `send_message` tool - **src/config.ts** - Environment configuration with Zod validation - **src/schema.ts** - Zod schemas for tool input/output validation - **src/providers/** - Chat provider implementations - **types.ts** - ChatProvider interface and types - **errors.ts** - Custom error classes - **index.ts** - Provider factory - **discord/** - Discord provider implementation Use the `discord.js` library for Discord integration. ## Docs - [Model Context Protocol (MCP)](https://modelcontextprotocol.org/) - [discord.js Documentation](https://discord.js.org/docs) ## Environment Variables - `DISCORD_API_KEY` (required) - Discord bot token - `DISCORD_CHANNEL_ID` (required) - Discord channel ID for messages - `CHAT_TIMEOUT_MS` (optional, default: 600000) - Response timeout in milliseconds - `NODE_ENV` (optional, default: development) - Environment mode