home / mcp / knowledge mcp server

Knowledge MCP Server

Provides an MCP-enabled knowledge base with API docs, search, and proxy actions across multiple sources.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "atnguyen143-mcp": {
      "url": "https://mcp.soleenterprises.com/mcp"
    }
  }
}

Knowledge Server (FastMCP) is an LLM-agnostic knowledge server that exposes MCP and REST endpoints to manage and query API documentation. It enables fast search, retrieval, and execution of API docs across multiple sources, making it easier for your language model workflows to discover and act on documentation.

How to use

You can connect an MCP client to the Knowledge Server to access, search, and proxy API documentation. Use the MCP endpoint to fetch specific API documentation, list all APIs and entities, or run a targeted search across docs. When integrated with Claude Desktop or Claude Code, you can call the knowledge tools directly through MCP to retrieve get_docs(api, entity), list_apis(), and search_docs(query), or to perform proxy_request actions against whitelisted hosts.

How to install

Prerequisites: you should have a running Python environment or a container runtime if you plan to deploy in Docker. You will also need an MCP client configuration to route requests to the Knowledge Server.

uv sync

uv run uvicorn app:app --reload --host 0.0.0.0 --port 8080

# Or with Docker
docker compose up --build

# Run tests
./test.sh
# Or test production:
./test.sh https://mcp.soleenterprises.com

Additional content

Endpoints you will use frequently include the MCP endpoint at /mcp for Claude Desktop/Code, the API docs at /api/docs, and the search interface at /search?q=query. A web UI is available at /ui, and a health check is exposed at /health. The knowledge structure stores API docs under a knowledge/apis directory, organized by API and entity, for example knowledge/apis/stockx_api/catalog.md.

MCP tools available when connected through an MCP client include: get_docs(api, entity) to fetch specific API docs, list_apis() to enumerate all APIs and entities, search_docs(query) to search across documentation, and proxy_request(method, url, body?, headers?) to execute HTTP requests against whitelisted hosts.

Platform usage notes: you can access via Claude Desktop/Code through the /mcp endpoint, Claude iOS/Browser by opening /ui and copying docs, or export the API definitions for use in external tools. If you are integrating with GPT-4 Custom GPT or Gemini, you can reference the provided actions or system prompts to describe the REST API surface.

Security and configuration notes

The server exposes a REST API and an MCP bridge. Ensure you run the server behind appropriate access controls and apply network allowlists for the proxy_request capability to prevent unauthorized outbound requests.

Available tools

get_docs

Fetch specific API documentation given an API name and an entity.

list_apis

List all available APIs and their entities.

search_docs

Search across all documentation using a query string.

proxy_request

Execute HTTP requests against whitelisted hosts using the MCP proxy.