iflow-mcp_jin38324_oci-documentation-mcp-server 0.0.1__tar.gz

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish Python Package to PyPI on Release
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish-to-pypi:
+    name: Build and Publish
+    runs-on: ubuntu-latest
+    permissions:
+      # 仅允许写入 GitHub 的 id-token（用于 OIDC，如需要）
+      id-token: write
+      # 仅允许读取 secrets.PYPI_TOKEN
+      contents: read
+    environment:
+      name: pypi
+      url: https://pypi.org/p/oci-documentation-mcp-server
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - name: Upgrade build tools
+        run: |
+          python -m pip install --upgrade pip
+
+      - name: Install build backend
+        run: |
+          pip install build
+
+      - name: Build distributions
+        # 这里自动从 pyproject.toml 读取配置，生成 sdist + wheel
+        run: |
+          python -m build --sdist --wheel
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/.gitignore

@@ -0,0 +1,61 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+tests/
+dev/
+
+# Ruff
+.ruff_cache/
+
+# Build
+*.manifest
+*.spec
+.pybuilder/
+target/
+
+# Environments
+.env
+.env.local
+.env.*.local
+
+# PyPI
+.pypirc

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v3.13.0
+    hooks:
+      - id: commitizen
+      - id: commitizen-branch
+        stages: [pre-push]

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/.python-version

@@ -0,0 +1 @@
+3.13

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/3025_process.log

@@ -0,0 +1,3 @@
+[2026-02-04 05:57:38 UTC] [IN_PROGRESS] 步骤1: 获取项目 - Fork并克隆项目成功
+[2026-02-04 05:57:44 UTC] [COMPLETED] 步骤2: 阅读代码 - 确认为Python MCP服务端项目
+[2026-02-04 06:00:09 UTC] [COMPLETED] 步骤3: 本地测试 - 构建成功，本地测试通过，发现2个工具

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.1] - 2025-04-21
+
+First release.
+
+### Added
+
+- Initial project setup

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_jin38324_oci-documentation-mcp-server
+Version: 0.0.1
+Summary: An  Model Context Protocol (MCP) server for OCI Documentation
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: googlesearch-python>=1.3.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: markdownify>=1.1.0
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: pydantic>=2.10.6
+Description-Content-Type: text/markdown
+
+*Inspired by: https://github.com/awslabs/mcp/tree/main/src/aws-documentation-mcp-server*
+
+# OCI Documentation MCP Server
+
+Model Context Protocol (MCP) server for OCI Documentation
+
+This MCP server provides tools to search for content, and access OCI documentation.
+
+## Features
+
+- **Read Documentation**: Fetch and convert OCI documentation pages to markdown format
+- **Search Documentation**: Search OCI documentation using search engine
+
+## Prerequisites
+
+### Installation Requirements
+
+1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
+2. Install Python 3.10 or newer using `uv python install 3.10` (or a more recent version)
+
+## Installation
+
+MCP config:
+
+```json
+{
+  "mcpServers": {
+      "oci-documentation-mcp-server": {
+        "command": "uvx",
+        "args": [
+          "--from",
+          "oci-documentation-mcp-server@latest",
+          "python",
+          "-m",
+          "oci_documentation_mcp_server.server"
+        ],
+        "env": {
+          "FASTMCP_LOG_LEVEL": "ERROR"
+        },
+        "disabled": false,
+        "autoApprove": []
+    },
+  }
+}
+
+```
+
+
+If above doesn't work, try below one:
+
+```json
+{
+  "mcpServers": {
+    "oci-documentation-mcp-server": {
+        "command": "uvx",
+        "args": ["oci-documentation-mcp-server@latest"],
+        "env": {
+          "FASTMCP_LOG_LEVEL": "ERROR"
+        },
+        "disabled": false,
+        "autoApprove": []
+    }
+  }
+}
+```
+
+## Basic Usage
+Example:
+ - In Cursor ask: `Write a function to download files for OCI Object Storage.`
+
+ ![Cursor_MCP](./image/Cursor_MCP.gif)
+ 
+
+
+
+
+## Tools
+
+### read_documentation
+
+Fetches an OCI documentation page and converts it to markdown format.
+
+```python
+read_documentation(url: str) -> str
+```
+
+### search_documentation
+
+Searches OCI documentation using the search engine.
+
+```python
+search_documentation(search_phrase: str, limit: int) -> list[dict]
+```

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/README.md

@@ -0,0 +1,93 @@
+*Inspired by: https://github.com/awslabs/mcp/tree/main/src/aws-documentation-mcp-server*
+
+# OCI Documentation MCP Server
+
+Model Context Protocol (MCP) server for OCI Documentation
+
+This MCP server provides tools to search for content, and access OCI documentation.
+
+## Features
+
+- **Read Documentation**: Fetch and convert OCI documentation pages to markdown format
+- **Search Documentation**: Search OCI documentation using search engine
+
+## Prerequisites
+
+### Installation Requirements
+
+1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
+2. Install Python 3.10 or newer using `uv python install 3.10` (or a more recent version)
+
+## Installation
+
+MCP config:
+
+```json
+{
+  "mcpServers": {
+      "oci-documentation-mcp-server": {
+        "command": "uvx",
+        "args": [
+          "--from",
+          "oci-documentation-mcp-server@latest",
+          "python",
+          "-m",
+          "oci_documentation_mcp_server.server"
+        ],
+        "env": {
+          "FASTMCP_LOG_LEVEL": "ERROR"
+        },
+        "disabled": false,
+        "autoApprove": []
+    },
+  }
+}
+
+```
+
+
+If above doesn't work, try below one:
+
+```json
+{
+  "mcpServers": {
+    "oci-documentation-mcp-server": {
+        "command": "uvx",
+        "args": ["oci-documentation-mcp-server@latest"],
+        "env": {
+          "FASTMCP_LOG_LEVEL": "ERROR"
+        },
+        "disabled": false,
+        "autoApprove": []
+    }
+  }
+}
+```
+
+## Basic Usage
+Example:
+ - In Cursor ask: `Write a function to download files for OCI Object Storage.`
+
+ ![Cursor_MCP](./image/Cursor_MCP.gif)
+ 
+
+
+
+
+## Tools
+
+### read_documentation
+
+Fetches an OCI documentation page and converts it to markdown format.
+
+```python
+read_documentation(url: str) -> str
+```
+
+### search_documentation
+
+Searches OCI documentation using the search engine.
+
+```python
+search_documentation(search_phrase: str, limit: int) -> list[dict]
+```

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/language.json

@@ -0,0 +1 @@
+python

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/oci_documentation_mcp_server/__init__.py

@@ -0,0 +1,11 @@
+# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+# with the License. A copy of the License is located at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+# and limitations under the License.
+"""oci-documentation-mcp-server"""
+
+__version__ = '0.0.1'

iflow_mcp_jin38324_oci_documentation_mcp_server-0.0.1/oci_documentation_mcp_server/models.py

@@ -0,0 +1,19 @@
+# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+# with the License. A copy of the License is located at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+# and limitations under the License.
+"""Data models for OCI Documentation MCP Server."""
+
+from pydantic import BaseModel
+from typing import Optional
+
+
+class SearchResult(BaseModel):
+    """Search result from OCI documentation search."""
+    title: str
+    url: str
+    description: Optional[str] = None