OCI Documentation MCP Server

参考：https://github.com/awslabs/mcp/tree/main/src/aws-documentation-mcp-server

OCI Documentation MCP Server

OCI Documentation 用の Model Context Protocol（MCP）サーバー

この MCP サーバーは、コンテンツを検索し、OCI ドキュメントにアクセスするためのツールを提供します。

変更履歴

• 2026-05-20：トランスポートとして stdio、sse、streamable-http をサポート
• 2026-05-19：検索エンジンを Oracle Help Center の検索に変更
• 2025-04-21：初回リリース

機能

oci_search_documentation

Oracle Help Center Search API を使用して OCI ドキュメントを検索し、構造化されたページの検索結果を返します。このツールは、ドキュメントのワークフローの最初のステップとして、ページを読む前に最も関連性の高い Oracle ドキュメントの URL を見つけることを目的としています。

パラメーター：

• search_phrase：検索テキストです。より良い検索結果を得るには、具体的な OCI サービス名、製品用語、エラーメッセージ、機能名を使用してください。
• limit：返す検索結果の最大数です。既定値は 3 です。
• page：検索結果のページ番号です。既定値は 1 です。

戻り値：

• Oracle Help Center の検索結果セットから取得したページネーションのメタデータ。
• タイトル、URL、説明を含むドキュメント検索結果のリスト。

設計上の留意点：

• 公開されている Oracle Help Center のページエンドポイントを使用します。

oci_read_documentation

OCI ドキュメントのページを読み込み、HTML から Markdown に変換し、行番号でインデックス化して、コンテンツの範囲を返します。このツールは、MCP の応答が大量にならないように、長いドキュメントの内容を制御しながら読むことを目的としています。

パラメーター：

• url：OCI ドキュメントのページ URL です。URL は docs.oracle.com のもので、.htm または .html で終わる必要があります。
• start_index：読み込みを開始する 0 基準の行番号です。既定値は 0 です。
• max_lines：返す Markdown の最大行数です。既定値は 10 です。

戻り値：

• stats：総行数、総単語数、開始行、返された行数、残りの行数、残りの単語数。
• content：指定した行範囲の Markdown テキスト。
• table_of_contents：start_index == 0 の場合にのみ返されます。見出しレベル、タイトル、0 基準の行番号が含まれます。

設計上の留意点：

• 長いドキュメントは文字オフセットではなく Markdown の行番号でページ分割されるため、エージェントが続きの内容を読み込みやすくなります。
• 変換されたページはプロセスメモリ内に 24 時間、最大 128 ページまでキャッシュされます。キャッシュには Markdown テキスト全体と分割した行を重複して保持しないよう、単一の行リスト表現が保存されます。
• 目次と関連リンクは、後続の読み込みでメタデータが繰り返されないよう、最初の読み込み時にのみ返されます。

使い方

オプション 1：PyPI パッケージから実行

既定の出力先は stdio です。変更する場合は --transport を使用してください。

{
  "mcpServers": {
    "oci-documentation-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "oci-documentation-mcp-server@latest",
        "python",
        "-m",
        "oci_documentation_mcp_server.server",
        "--transport",
        "stdio"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

オプション 2：ソースコードからローカルで実行し、stdio に出力

インストール要件

1. このリポジトリをダウンロードします。
2. Astral または GitHub README から uv をインストールします。

{
  "mcpServers": {
    "oci-documentation-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/oci-documentation-mcp-server"
        "run",
        "python",
        "-m",
        "oci_documentation_mcp_server.server",
        "--transport",
        "stdio"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

オプション 3：サーバーとして実行

Streamable HTTP を使用してサーバーとして実行します：

uv run python -m oci_documentation_mcp_server.server --transport "streamable-http" --port 8000 --path "/mcp"

エージェントツールの設定：

{
  "mcpServers": {
      "oci-documentation-mcp-server": {
      "type": "streamable-http",
      "url": "http://localhost:8000/mcp"
    }
  }
}