HTTP Client MCP Server

A specialized Model Context Protocol (MCP) server designed to help AI assistants (like Claude) explore, search, and read codebase repositories and API specifications efficiently.

Features

• Fast Content Search: Deep character-level search using ripgrep (rg).
• File Exploration: List directories and search for files by name.
• API Spec Specialist: Optimized for reading OpenAPI/Swagger specs (YAML/JSON) and Markdown documentation.
• Token Efficiency: smart pruning of API specs to remove verbose descriptions and repetitive examples, saving your LLM context.
• Caching: Intelligent caching for improved performance.

Prerequisites

• Node.js: Version 18 or higher.
• ripgrep: High-performance search tool required for the search_content tool.

  # macOS
  brew install ripgrep
  # Windows
  choco install ripgrep

Installation

You can run this server directly using npx:

npx http-client-mcp-server /path/to/your/repo

Configuration (Claude Desktop)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "repo-explorer": {
      "command": "npx",
      "args": [
        "-y",
        "http-client-mcp-server",
        "/absolute/path/to/your/repo"
      ]
    }
  }
}

Available Tools

1. search_content

Search for keywords or regex patterns inside files.

• keyword: The pattern to search for.
• file_extension: (Optional) Filter by file type (e.g., ts, go).

2. read_api_spec

Read large files with optional line range support.

• filepath: Path to the file.
• startLine/endLine: (Optional) Specific lines to read.

3. read_specific_endpoint

Extract a specific endpoint and method from an OpenAPI spec or Markdown doc.

• filepath: Spec file path.
• endpointPath: e.g., /v1/users.
• method: e.g., get.

4. list_directory

List files in a directory (ignores node_modules, .git, etc.).

5. search_files

Quickly find files by name.

Development

npm install
npm run build
npm test

License

ISC