Skip to main content
Glama
deenesjakoruzh
michaelgerkeadesso

ChatWithMCP

by michaelgerkeadesso
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

ChatWithMCP

Ein Kommandozeilen-Chat-Client für Claude (Anthropic) mit Anbindung an eigene und externe MCP-Server. Der Chat läuft direkt im Terminal, ruft Tools automatisch (oder nach Rückfrage) auf und bringt ein eingebautes System zum Generieren und Bewerten von Prompt-Varianten mit.

Features

  • Interaktiver Chat im Terminal (OpenAI-kompatible API, openai-SDK gegen Anthropic-Endpoint)

  • Anbindung eines lokalen MCP-Servers (mcp-server/) mit eigenen Tools

  • Optionale Anbindung des offiziellen GitHub MCP Servers über Docker

  • Drei Ausführungs-Modi für Tool-Aufrufe: auto, approve (Rückfrage) und plan (nur Plan, keine Ausführung)

  • Streaming-Antworten und Extended Thinking (optional zuschaltbar)

  • Tools einzeln oder komplett de-/aktivierbar

  • Dateien per /attach in den Chat-Kontext laden

  • Prompt-Generierung und -Evaluierung über eigene MCP-Tools (siehe PROMPT_EVALUATION.md)

Related MCP server: MCP Chat

Voraussetzungen

  • Node.js (ESM/type: module, siehe package.json)

  • Ein Anthropic API-Key

  • Optional: Docker (nur für den GitHub-MCP-Server) und ein GitHub Personal Access Token

  • Optional: ein Tavily API-Key (für die web_search-Tool)

Installation

npm install

Konfiguration

Lege eine .env-Datei im Projektwurzelverzeichnis an (wird von .gitignore ausgeschlossen):

ANTHROPIC_API_KEY=dein-anthropic-api-key
BASE_URL=https://api.anthropic.com/v1
TAVILY_API_KEY=dein-tavily-api-key
GITHUB_PERSONAL_ACCESS_TOKEN=dein-github-token

  • ANTHROPIC_API_KEY / BASE_URL — werden für den Chat-Client und das generate_prompts-Tool benötigt

  • TAVILY_API_KEY — nur nötig für das web_search-Tool

  • GITHUB_PERSONAL_ACCESS_TOKEN — nur nötig, wenn der GitHub-MCP-Server (via Docker) genutzt werden soll

Allgemeine Einstellungen (Modell, Token-Limits, Basisverzeichnis für /attach, GitHub-Toolsets) stehen in config.mjs.

Nutzung

Chat starten:

npm start

Der lokale MCP-Server (mcp-server/server.mjs) wird dabei automatisch als Subprozess gestartet. Der GitHub-MCP-Server wird optional über Docker verbunden — schlägt das fehl, läuft der Chat ohne GitHub-Tools weiter.

Den MCP-Server lässt sich auch unabhängig starten (z. B. zum Testen mit einem MCP-Inspector):

npm run mcp-server

Befehle im Chat

Allgemein

  • /system TEXT — System-Prompt setzen

  • /nosystem — System-Prompt entfernen

  • /clear — Chat-Verlauf löschen

  • exit — Chat beenden

Tool-Verwaltung

  • /tools — verfügbare Tools mit Status anzeigen

  • /disable-tool <name> / /enable-tool <name> — einzelnes Tool de-/aktivieren

  • /disable-all-tools / /enable-all-tools — alle Tools de-/aktivieren

Chat-Optionen

  • /options — aktuelle Einstellungen anzeigen

  • /enable-streaming / /disable-streaming — Streaming umschalten (deaktiviert währenddessen alle Tools)

  • /enable-thinking / /disable-thinking — Extended Thinking umschalten

Ausführungs-Modus

  • /plan-mode — Modell liefert nur einen Plan, führt keine Tools aus

  • /auto-mode — Tools werden ohne Rückfrage ausgeführt (Standard)

  • /auto-approve — vor jedem Tool-Aufruf muss bestätigt werden

  • /mode — aktuellen Modus anzeigen

Dateien

  • /attach <pfad> — Datei einlesen und dem Chat-Verlauf hinzufügen (relative Pfade werden gegen config.attachBaseDir aufgelöst)

Prompt Evaluation

  • /generate-prompts <count> <prompt> [--style=formal|casual|technical|creative|concise]

  • /evaluate-prompts

  • /prompts

  • /clear-prompts

Details dazu in PROMPT_EVALUATION.md.

Verfügbare MCP-Tools

Der lokale MCP-Server (mcp-server/tools/) stellt u. a. folgende Tools bereit:

Tool

Beschreibung

get_current_date / get_current_time

Liefert aktuelles Datum bzw. aktuelle Uhrzeit

get_weather

Wetterabfrage

web_search

Websuche (benötigt TAVILY_API_KEY)

fetch_page

Lädt eine Webseite und wandelt sie in Text um

read_file / save_to_file

Dateien lesen bzw. schreiben

list_directory

Verzeichnisinhalt auflisten

ssh_execute

Befehle auf einem entfernten Host per SSH ausführen

get_network_info

Netzwerkschnittstellen, Subnetze und DNS-Server des Rechners anzeigen

discover_network_hosts

Aktive Hosts im lokalen IP-Netzwerk per TCP-Connect-Scan finden

generate_prompts / evaluate_prompts

Prompt-Varianten erzeugen und bewerten

Über den optionalen GitHub-MCP-Server stehen zusätzlich Tools für Repos, Issues, Pull Requests und Actions zur Verfügung (siehe config.mjs → github.toolsets).

Projektstruktur

chat.mjs                 CLI-Chat-Client
config.mjs                Konfiguration (Modell, Token-Limits, GitHub-Optionen)
mcp-server/
  server.mjs              MCP-Server (stdio)
  tools/                  Einzelne Tool-Implementierungen
output/                   Ablage für generierte Dateien (z. B. über save_to_file)
PROMPT_EVALUATION.md       Dokumentation des Prompt-Evaluation-Systems

This server cannot be installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • RogerRat

    Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/michaelgerkeadesso/ChatWithMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server