internal-tool-docs-mcp 0.1.0__tar.gz

internal_tool_docs_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,53 @@
+name: Test and Publish
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install package
+        run: uv sync
+
+      - name: Test import
+        run: uv run python -c "from mcp_internal_tool_docs import main; print('OK')"
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

internal_tool_docs_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Pradas
+
+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.

internal_tool_docs_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: internal-tool-docs-mcp
+Version: 0.1.0
+Summary: MCP server that serves llms.txt package documentation from a directory
+Author: Alex Pradas
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: fastmcp
+Description-Content-Type: text/markdown
+
+# internal-tool-docs-mcp
+
+A lightweight MCP server that serves `llms.txt` API documentation for internal packages.
+
+## Install
+
+```bash
+pip install internal-tool-docs-mcp
+```
+
+## Usage
+
+Place your package documentation files in a directory, named `<package-name>.txt`:
+
+```
+docs/
+├── ductile-loads.txt
+├── my-other-tool.txt
+```
+
+Run the server:
+
+```bash
+internal-tool-docs-mcp --path ./docs
+```
+
+Or via `uvx` (no install needed):
+
+```bash
+uvx internal-tool-docs-mcp --path ./docs
+```
+
+## Configure in `.mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "internal-tool-docs": {
+      "command": "uvx",
+      "args": ["internal-tool-docs-mcp", "--path", "./docs"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_packages()` | List available package documentation |
+| `get_package_docs(package_name)` | Get the llms.txt content for a package |
+
+## License
+
+MIT

internal_tool_docs_mcp-0.1.0/README.md

@@ -0,0 +1,55 @@
+# internal-tool-docs-mcp
+
+A lightweight MCP server that serves `llms.txt` API documentation for internal packages.
+
+## Install
+
+```bash
+pip install internal-tool-docs-mcp
+```
+
+## Usage
+
+Place your package documentation files in a directory, named `<package-name>.txt`:
+
+```
+docs/
+├── ductile-loads.txt
+├── my-other-tool.txt
+```
+
+Run the server:
+
+```bash
+internal-tool-docs-mcp --path ./docs
+```
+
+Or via `uvx` (no install needed):
+
+```bash
+uvx internal-tool-docs-mcp --path ./docs
+```
+
+## Configure in `.mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "internal-tool-docs": {
+      "command": "uvx",
+      "args": ["internal-tool-docs-mcp", "--path", "./docs"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_packages()` | List available package documentation |
+| `get_package_docs(package_name)` | Get the llms.txt content for a package |
+
+## License
+
+MIT

internal_tool_docs_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "internal-tool-docs-mcp"
+version = "0.1.0"
+description = "MCP server that serves llms.txt package documentation from a directory"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.13"
+authors = [{ name = "Alex Pradas" }]
+dependencies = ["fastmcp"]
+
+[project.scripts]
+internal-tool-docs-mcp = "mcp_internal_tool_docs:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_internal_tool_docs"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

internal_tool_docs_mcp-0.1.0/src/mcp_internal_tool_docs/__init__.py

@@ -0,0 +1,38 @@
+import argparse
+from pathlib import Path
+
+from fastmcp import FastMCP
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="MCP server for llms.txt package documentation"
+    )
+    parser.add_argument(
+        "--path",
+        type=Path,
+        required=True,
+        help="Directory containing llms.txt files (named <package>.txt)",
+    )
+    args = parser.parse_args()
+    docs_dir = args.path.resolve()
+
+    mcp = FastMCP("internal-tool-docs")
+
+    @mcp.tool()
+    def list_packages() -> list[str]:
+        """List available package documentation."""
+        return [f.stem for f in sorted(docs_dir.glob("*.txt"))]
+
+    @mcp.tool()
+    def get_package_docs(package_name: str) -> str:
+        """Get the llms.txt documentation for a package."""
+        file = docs_dir / f"{package_name}.txt"
+        if not file.exists():
+            available = [f.stem for f in docs_dir.glob("*.txt")]
+            raise ValueError(
+                f"No documentation for '{package_name}'. Available: {available}"
+            )
+        return file.read_text()
+
+    mcp.run()