trackmcp
Back to directory
codeChap

mcp-server-claude-chat

View on GitHub

MCP server for the Anthropic Claude Messages API — chat, vision, web search, extended thinking (Rust, stdio/JSON-RPC)

0 stars RustOthers Updated Aug 26, 2026

Documentation

mcp-server-claude-chat

An MCP (Model Context Protocol) server for the Anthropic Claude Messages API. Built in Rust, it exposes chat, vision, live web search, and model listing as MCP tools — so any MCP client (Claude Desktop, Claude Code, etc.) can consult Claude as a tool.

Communicates via stdio using JSON-RPC 2.0, like all the other MCP servers in this collection. Structurally it mirrors `mcp-server-grok-chat` / `mcp-server-gpt-chat`, adapted to Anthropic's API shape.

Subscription vs. API credits

This server uses the Anthropic API with an API key (API credits). That is the only supported, terms-compliant way to drive Claude from a third-party tool.

A Claude Pro/Max subscription (the kind that powers Claude Code and the Claude apps) is *not* usable here: that authentication is licensed for Anthropic's own first-party clients, and routing it through a custom server would violate Anthropic's Consumer Terms — the "$200 of Claude usage from another service" concern you raised. So: API key it is. (If you run an Anthropic-compatible gateway, point `base_url` at it — see Configuration.)

Tools

ToolDescription
`chat`Send a message to Claude. Supports multi-turn history, a system prompt, model selection, and extended thinking via `thinking_budget`.
`chat_with_vision`Analyse an image given an image URL and a text prompt.
`chat_with_search`Chat with live web search — Claude searches server-side and answers with cited sources.
`list_models`List available Claude models and their IDs (cached for 5 minutes).

> Note: Anthropic has no embeddings endpoint (they recommend Voyage AI), so unlike the grok/gpt servers there is no `embedding` tool.

chat

NameTypeRequiredDescription
`prompt`stringyesThe user message to send
`system_prompt`stringnoSystem prompt to set context/behaviour
`messages`stringnoConversation history as a JSON array of `{role, content}` objects (roles: `user`/`assistant` only — use `system_prompt` for system instructions)
`model`stringnoModel ID (default: server default, `claude-opus-4-8`). Call `list_models`.
`temperature`floatnoSampling temperature (0.0–1.0). Ignored when `thinking_budget` is set.
`max_tokens`integernoMax tokens to generate (defaults to the server default)
`thinking_budget`integernoEnable extended thinking with this token budget (min 1024). Reasoning is returned in a `[thinking]` block; `max_tokens` is auto-raised above the budget.

chat_with_vision

NameTypeRequiredDescription
`prompt`stringyesText prompt describing what to analyse
`image_url`stringyesURL of the image (must be `http://` or `https://`)
`model`stringnoVision-capable model ID (default: server default)
`temperature`floatnoSampling temperature (0.0–1.0)
`max_tokens`integernoMax tokens to generate
NameTypeRequiredDescription
`prompt`stringyesThe user message
`system_prompt`stringnoSystem prompt
`model`stringnoModel ID (default: server default)
`temperature`floatnoSampling temperature (0.0–1.0)
`max_tokens`integernoMax tokens to generate
`max_uses`integernoMax web searches Claude may run for this request (default: 5)

Web search is billed by Anthropic at $10 per 1,000 searches on top of token costs, and an org admin must enable web search in the Claude Console.

list_models

No parameters. Results cached for 5 minutes.

Prerequisites

Setup

bash
mkdir -p ~/.config/mcp-server-claude-chat
cp config.toml.example ~/.config/mcp-server-claude-chat/config.toml
# then edit it and set api_key

Config (`~/.config/mcp-server-claude-chat/config.toml`):

toml
api_key = "sk-ant-..."

# Optional:
# base_url = "https://api.anthropic.com/v1"   # or a compatible gateway
# default_model = "claude-opus-4-8"
# default_max_tokens = 4096

The server fails fast at startup if the config is missing or `api_key` is empty.

Build

bash
cargo build --release   # produces target/release/claude-chat
cargo build             # debug build
cargo run               # run in dev mode
RUST_LOG=debug cargo run
cargo test              # unit tests (response formatting, validation, message building)

MCP Configuration

Claude Desktop (`~/.config/Claude/claude_desktop_config.json`) or any MCP client:

json
{
  "mcpServers": {
    "claude-chat": {
      "command": "/media/codechap/4TB/develop/mcps/mcp-server-claude-chat/target/release/claude-chat"
    }
  }
}

Claude Code:

bash
claude mcp add claude-chat -- /media/codechap/4TB/develop/mcps/mcp-server-claude-chat/target/release/claude-chat

Project Structure

code
src/
  main.rs    - entry point, config loading, stdio transport setup
  server.rs  - MCP tool definitions (chat, chat_with_vision, chat_with_search, list_models)
  api.rs     - Anthropic HTTP client, Messages/Models types, response formatter
  params.rs  - tool parameter types with serde + JSON Schema derives
  config.rs  - TOML config loading

License

MIT

Frequently asked questions

What is mcp-server-claude-chat?

mcp-server-claude-chat is MCP server for the Anthropic Claude Messages API — chat, vision, web search, extended thinking (Rust, stdio/JSON-RPC)

How do I install mcp-server-claude-chat?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-server-claude-chat open source?

Yes — it is hosted on GitHub at https://github.com/codeChap/mcp-server-claude-chat.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP