iflow-mcp_vzeman-odoo-mcp-server 0.2.0__tar.gz

iflow_mcp_vzeman_odoo_mcp_server-0.2.0/.dockerignore

@@ -0,0 +1,73 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Local files
+.env
+.env.local
+.env.*.local
+*.local
+
+# Logs
+logs/
+*.log
+
+# Test files
+test_*.py
+tests/
+
+# Coverage
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.pytest_cache/
+.hypothesis/

iflow_mcp_vzeman_odoo_mcp_server-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      test_pypi:
+        description: 'Publish to Test PyPI instead of PyPI'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check package
+      run: twine check dist/*
+    
+    - name: Publish to Test PyPI
+      if: github.event.inputs.test_pypi == 'true'
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        twine upload --repository testpypi dist/*
+    
+    - name: Publish to PyPI
+      if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.test_pypi != 'true')
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        twine upload dist/*

iflow_mcp_vzeman_odoo_mcp_server-0.2.0/.gitignore

@@ -0,0 +1,191 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test files
+test_*.py
+
+# Local configuration
+*.local
+.env.local
+.env.*.local
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Docker Compose with credentials (keep example file)
+docker-compose.yml
+docker-compose.override.yml
+
+# Logs
+logs/
+*.log
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test files
+test_*.py
+tests/
+
+# Coverage
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.pytest_cache/
+.hypothesis/

iflow_mcp_vzeman_odoo_mcp_server-0.2.0/CLAUDE.md

@@ -0,0 +1,112 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a hybrid MCP (Model Context Protocol) server for Odoo ERP integration. It supports both:
+- **HTTP Streaming**: For web-based AI agents and remote access
+- **stdio**: For local AI assistants like Claude Desktop
+
+## Architecture
+
+### Dual Implementation
+
+1. **HTTP Mode** (`http_server.py`):
+   - FastAPI-based HTTP server
+   - Supports ngrok for remote access
+   - Includes caching and advanced features
+   - Used for AI agents like Flowhunt
+
+2. **stdio Mode** (`server.py`):
+   - Standard MCP stdio implementation
+   - Direct integration with Claude Desktop
+   - Simpler, lightweight implementation
+
+### Core Components
+
+- **`odoo_service.py`**: Advanced service for HTTP mode with caching
+- **`odoo_client.py`**: Simple client for stdio mode
+- **`config.py`**: Configuration management with Pydantic
+- **`cache_service.py`**: Caching system for HTTP mode
+
+## Development Commands
+
+```bash
+# Install dependencies
+pip install -e .
+pip install -e ".[dev]"  # For development with test dependencies
+
+# Run HTTP server
+python -m mcp_server_odoo.http_server
+
+# Run stdio server
+python -m mcp_server_odoo
+
+# Run tests
+pytest
+pytest --cov  # With coverage report
+
+# Type checking
+mypy mcp_server_odoo
+
+# Linting
+ruff check .
+ruff format .
+```
+
+## Environment Configuration
+
+### HTTP Mode
+Uses comprehensive configuration via `config.py`:
+- Odoo credentials
+- Server settings
+- Cache configuration
+
+### stdio Mode
+Uses simple environment variables:
+- `ODOO_URL`
+- `ODOO_DB`
+- `ODOO_USERNAME`
+- `ODOO_API_KEY` or `ODOO_PASSWORD`
+
+## Usage Patterns
+
+### HTTP Mode (AI Agents)
+```python
+# For Flowhunt and other AI platforms
+# Configure MCP server URL: https://your-ngrok-url.ngrok-free.app
+```
+
+### stdio Mode (Claude Desktop)
+```json
+{
+  "mcpServers": {
+    "odoo": {
+      "command": "python",
+      "args": ["-m", "mcp_server_odoo"],
+      "env": {
+        "ODOO_URL": "https://your-instance.odoo.com",
+        "ODOO_DB": "your-database",
+        "ODOO_USERNAME": "your-email@example.com",
+        "ODOO_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Testing Approach
+
+- Unit tests for both implementations
+- Integration tests with mock Odoo responses
+- Test MCP protocol compliance for both modes
+- Validate error handling and edge cases
+
+## Security Considerations
+
+- Never expose Odoo credentials in logs or error messages
+- Validate and sanitize all inputs before sending to Odoo
+- Use API keys instead of passwords when possible
+- Implement proper SSL context handling
+- Follow principle of least privilege for Odoo user permissions

iflow_mcp_vzeman_odoo_mcp_server-0.2.0/Dockerfile

@@ -0,0 +1,37 @@
+# Use Python 3.11 slim image
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy all files first
+COPY . .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -e .
+
+# Create non-root user
+RUN useradd --create-home --shell /bin/bash app \
+    && chown -R app:app /app
+USER app
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD python -c "import requests; requests.get('http://localhost:8000/health')" || exit 1
+
+# Run the application
+CMD ["python", "-m", "mcp_server_odoo.http_server"]