http4k MCP 桌面客户端
概览
一款命令行桌面客户端，通过标准输入/输出（StdIO）连接到MCP（模型上下文协议）服务器。该客户端设计为无缝与通过StdIO通信的AI助手和应用程序，如Claude及其他桌面AI应用。 http4k MCP 桌面客户端作为代理，支持桌面应用与 MCP 服务器之间的通信。虽然它适用于任何符合 MCP 标准的服务器，但针对使用 http4k MCP SDK 构建的服务器进行了特别优化。 - 多种远程传输选项：HTTP 流式传输、SSE（服务器发送事件）、JSON-RPC、WebSocket - 多种认证方法：API 密钥、持有令牌、基本认证和 OAuth - 可定制的重连策略 - 简单的 StdIO 界面，便于使用原生编译的 Kotlin 应用与桌面应用集成。 MCP标准的远程协议是HTTP Streaming，该协议在2025年3月26日版本中取代了之前的标准（SSE）。
概述（AI 翻译）
一个命令行桌面客户端，通过标准输入/输出（StdIO）连接MCP（模型上下文协议）服务器。该客户端设计为工作 与通过StdIO通信的AI助手和应用程序无缝衔接，如Claude及其他桌面AI应用。
概述
http4k MCP 桌面客户端作为代理，使桌面应用程序与 MCP 服务器之间的通信成为可能。虽然它支持任何符合 MCP 标准的 服务器，它专门针对使用 http4k MCP SDK 构建的服务器进行了优化。
特色
- 多种远程传输选项：HTTP 流式传输、SSE（服务器发送事件）、JSON-RPC、WebSocket
- 多种认证方法：API 密钥、持有令牌、基本认证和 OAuth
- 可定制重连策略
- 简单的 StdIO 接口，便于在使用原生编译的 Kotlin 应用时与桌面应用集成。
远程协议比较
MCP标准的远程协议是HTTP Streaming，它在2025-03-26版本中取代了之前的标准（SSE）。http4k在HTTP4K-MCP-Desktop中实现了其他标准传输，因为这些更适合分布式/托管的MCP服务器。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
http4k MCP Desktop Client
A command-line desktop client for connecting to MCP (Model Context Protocol) servers via standard input/output (StdIO). This client is designed to work seamlessly with AI assistants and applications that communicate through StdIO, such as Claude and other desktop AI applications.
Overview
The http4k MCP Desktop Client serves as a proxy that enables communication between desktop applications and MCP servers. While it works with any MCP-compliant server, it’s specially optimized for servers built using the http4k MCP SDK.
Features
- Multiple remote transport options: HTTP Streaming, SSE (Server-Sent Events), JSON-RPC, WebSocket
- Various authentication methods: API Key, Bearer Token, Basic Auth, and OAuth
- Customizable reconnection strategy
- Simple StdIO interface for easy integration with desktop applications when using natively compiled Kotlin apps.
Remote Protocol Comparison
The MCP Standard remote protocol is HTTP Streaming, which superceded the previous standard (SSE) in the 2025-03-26 version. http4k has implemented other standard transports into the http4k-mcp-desktop, as these will be more appropriate for distributed/hosted MCP servers.
| Protocol | Standard/Extension | State | Default server path | Setting | Description |
|---|---|---|---|---|---|
| HTTP Non-streaming | MCP Standard | Stateless | http://host/mcp |
http-nonstream |
Pure HTTP-based streaming communication Use this setting for Cursor! |
| HTTP Streaming | MCP Standard | Stateful | http://host/mcp |
http-stream |
HTTP/SSE-based streaming communication. Supports sessions and replaying/reconnection of stram |
| SSE | MCP (Legacy) | Stateful | http://host/sse |
sse |
Server-Sent Events, part of HTML5 spec, ideal for streaming data from server to client |
| WebSocket | Protocol Extension | Stateful | http://host/ws |
websocket |
Full-duplex communication protocol, maintains persistent connection |
| JSON-RPC | Protocol Extension | Stateless | http://host/jsonrpc |
jsonrpc |
Remote Procedure Call protocol encoded in JSON, request/response model |
Installation
Via Homebrew
brew tap http4k/tap
brew install http4k-mcp-desktop
Via GitHub Releases
Download the latest release from GitHub Releases.
Usage
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →