Host
A CLI host application that enables Large Language Models (LLMs) to interact with external tools through the Model Context Protocol (MCP).
A CLI host application that enables Large Language Models (LLMs) to interact with external tools through the Model Context Protocol (MCP).
{
"mcpServers": {
"filesystem": {
"type": "local",
"command": [
"npx",
"@modelcontextprotocol/server-filesystem",
"${env://WORK_DIR:-/tmp}"
],
"environment": {
"DEBUG": "${env://DEBUG:-false}",
"LOG_LEVEL": "${env://LOG_LEVEL:-info}",
"API_TOKEN": "${env://FS_API_TOKEN}"
},
"allowedTools": [
"read_file",
"write_file"
],
"excludedTools": [
"delete_file"
]
},
"github": {
"type": "local",
"command": [
"docker",
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN=${env://GITHUB_TOKEN}",
"ghcr.io/github/github-mcp-server"
],
"environment": {
"DEBUG": "${env://DEBUG:-false}"
}
},
"sqlite": {
"type": "local",
"command": [
"uvx",
"mcp-server-sqlite",
"--db-path",
"${env://DB_PATH:-/tmp/foo.db}"
],
"environment": {
"SQLITE_DEBUG": "${env://DEBUG:-0}",
"DATABASE_URL": "${env://DATABASE_URL:-sqlite:///tmp/foo.db}"
}
}
}
}
# ⚠️ MCPHost is No Longer Actively Maintained **Active development on MCPHost has been stopped.** This project has been succeeded by [**Kit**](https://github.com/mark3labs/kit), which builds on the foundations of MCPHost with a more powerful and extensible architecture. 👉 **We recommend all users migrate to [Kit](https://github.com/mark3labs/kit).** This repository is now archived and will not receive further updates or bug fixes. --- # MCPHost 🤖 A CLI host application that enables Large Language Models (LLMs) to interact with external tools through the Model Context Protocol (MCP). Currently supports Claude, OpenAI, Google Gemini, and Ollama models. Discuss the Project on [Discord](https://discord.gg/RqSS2NQVsY) ## Table of Contents - [Overview](#overview-) - [Features](#features-) - [Requirements](#requirements-) - [Environment Setup](#environment-setup-) - [Installation](#installation-) - [SDK Usage](#sdk-usage-) - [Configuration](#configuration-) - [MCP Servers](#mcp-servers) - [Environment Variable Substitution](#environment-variable-substitution) - [Simplified Configuration Schema](#simplified-configuration-schema) - [Tool Filtering](#tool-filtering) - [Legacy Configuration Support](#legacy-configuration-support) - [Transport Types](#transport-types) - [System Prompt](#system-prompt) - [Usage](#usage-) - [Interactive Mode](#interactive-mode-default) - [Script Mode](#script-mode) - [Hooks System](#hooks-system) - [Non-Interactive Mode](#non-interactive-mode) - [Model Generation Parameters](#model-generation-parameters) - [Available Models](#available-models) - [Examples](#examples) - [Flags](#flags) - [Authentication Subcommands](#authentication-subcommands) - [Configuration File Support](#configuration-file-support) - [Interactive Commands](#interactive-commands) - [Automation & Scripting](#automation--scripting-) - [MCP Server Compatibility](#mcp-server-compatibility-) - [Contributing](#contributing-) - [License](#license-) - [Acknowledgments](#acknowledgments-) ## Overview 🌟 MCPHost acts as a host in the MCP client-server architecture, where: - **Hosts** (like MCPHost) are LLM applications that manage connections and interactions - **Clients** maintain 1:1 connections with MCP servers - **Servers** provide context, tools, and capabilities to the LLMs This architecture allows language models to: - Access external tools and data sources 🛠️ - Maintain consistent context across interactions 🔄 - Execute commands and retrieve information safely 🔒 Currently supports: - Anthropic Claude models (Claude 3.5 Sonnet, Claude 3.5 Haiku, etc.) - OpenAI models (GPT-4, GPT-4 Turbo, GPT-3.5, etc.) - Google Gemini models (Gemini 2.0 Flash, Gemini 1.5 Pro, etc.) - Any Ollama-compatible model with function calling support - Any OpenAI-compatible API endpoint ## Features ✨ - Interactive conversations with multiple AI models - **Non-interactive mode** for scripting and automation - **Script mode** for executable YAML-based automation scripts - Support for multiple concurrent MCP servers - **Tool filtering** with `allowedTools` and `excludedTools` per server - Dynamic tool discovery and integration - Tool calling capabilities across all supported models - Configurable MCP server locations and arguments - Consistent command interface across model types - Configurable message history window for context management - **OAuth authentication** support for Anthropic (alternative to API keys) - **Hooks s...
Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!
Chrome MCP Server is a Chrome extension-based Model Context Protocol (MCP) server that exposes your Chrome browser funct...
Unity MCP acts as a bridge, allowing AI assistants (like Claude, Cursor) to interact directly with your Unity Editor via...
A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and exte...
Build effective agents using Model Context Protocol and simple workflow patterns
A community driven registry service for Model Context Protocol (MCP) servers.