@jkumonpm/chat-companion-mcp

AI Chat Companion MCP server. Natural conversation with Gemini AI (free tier).

No complex prompts. Just talk.

Install

npm install -g @jkumonpm/chat-companion-mcp

Usage

Claude Desktop / Cursor / OpenCode

Add to your MCP config:

{
  "mcpServers": {
    "chat": {
      "command": "npx",
      "args": ["-y", "@jkumonpm/chat-companion-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: You need a Google Gemini API key. Get one for free at Google AI Studio.

Tools

chat — Chat with AI Companion

Have a natural conversation with an AI companion. Pass the previous session ID to maintain context.

Input:

{
  "message": "你好，今天過得如何？",
  "session": "optional-session-id-from-previous-response"
}

Output:

{
  "reply": "你好！我今天過得很不錯，謝謝你的問候。那你呢？今天過得還順利嗎？",
  "session": "c6f2f121-bb24-4922-86b8-ed95bb17dbe8"
}

How Session Memory Works

1. First message: Don't pass session. AI creates a new conversation.
2. Continue conversation: Pass the session ID from the previous response.
3. Start fresh: Don't pass session to begin a new conversation.
4. Auto-cleanup: Sessions expire after 5 minutes of inactivity.

Design

| Feature | Why | |---------|-----| | Free tier model | Uses gemini-3-flash-preview — no cost for users | | No complex prompts | AI decides how to respond naturally | | Session memory | Sliding window (last 20 messages) for context | | Auto-cleanup | Expired sessions cleared every 60 seconds | | Multi-language | Automatically responds in user's language |

License

MIT