oci-documentation

This MCP server provides tools to search OCI documentation and convert documentation pages to Markdown for easy consumption. It exposes two primary tools: read_documentation, which fetches an OCI Documentation page and converts it to Markdown, and search_documentation, which queries OCI documentation using a search engine and returns results. To run the server, use the installation method described in the installation section and start the MCP server configuration. Once running, you can issue calls to the tools via your MCP client to retrieve or search documentation content as needed.

Prerequisites:

• Python 3.10 or newer installed on your system
• uv (Astral) installed or available in your environment

Installation steps:

1. Install uv if you haven't already (per your platform, e.g. via Astral or the uv README):

# Example (depends on your environment)
# Follow the official guidance to install uv

2. Install the OCI Documentation MCP Server package (via uvx as described in the repository):

# Using the recommended method from the README
uvx --from oci-documentation-mcp-server@latest python -m oci_documentation_mcp_server.server

3. Alternatively, if the above doesn’t work, try running the simpler form:

uvx oci-documentation-mcp-server@latest

4. Ensure the environment variable is set as in the README (optional but recommended):

export FASTMCP_LOG_LEVEL=ERROR

5. Confirm the MCP server starts and is reachable via your MCP client, then proceed to use read_documentation and search_documentation tools.

Tips and notes:

• The server uses Python-based tooling; ensure Python 3.10+ is installed.
• If you encounter connection or logging issues, adjust FASTMCP_LOG_LEVEL to DEBUG temporarily for more visibility.
• When using the uvx approach, use the latest tag or specific version as needed (oci-documentation-mcp-server@latest).
• The tools exposed are read_documentation(url) -> string (Markdown) and search_documentation(search_phrase, limit) -> list of dicts; tailor your MCP client calls to handle the response formats.
• If you modify environment variables, restart the MCP server to apply changes.