sap-datasphere-mcp 0.1.0__tar.gz

sap_datasphere_mcp-0.1.0/.env.example

@@ -0,0 +1,22 @@
+# SAP Datasphere Configuration
+DATASPHERE_TENANT_URL=https://your-tenant-id.eu10.hcs.cloud.sap
+DATASPHERE_TENANT_ID=your-tenant-id
+
+# OAuth 2.0 Credentials (from SAP Datasphere Admin Console)
+OAUTH_CLIENT_ID=sb-your-client-id!b130936|client!b3944
+OAUTH_CLIENT_SECRET=your-client-secret
+OAUTH_TOKEN_URL=https://your-subdomain.authentication.eu20.hana.ondemand.com/oauth/token
+OAUTH_AUTHORIZATION_URL=https://your-subdomain.authentication.eu20.hana.ondemand.com/oauth/authorize
+
+# Optional: Logging Configuration
+LOG_LEVEL=INFO
+LOG_FORMAT=json
+
+# Optional: API Configuration
+API_TIMEOUT=30
+API_RETRY_COUNT=3
+API_RATE_LIMIT=100
+
+# Optional: Cache Configuration
+CACHE_ENABLED=true
+CACHE_TTL=300

sap_datasphere_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Configure with '...'
+2. Run command '....'
+3. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment:**
+ - OS: [e.g. Windows, macOS, Linux]
+ - Python version: [e.g. 3.11]
+ - SAP Datasphere MCP version: [e.g. 0.1.0]
+ - SAP Datasphere tenant region: [e.g. eu10, us10]
+
+**Configuration (remove sensitive data):**
+```env
+DATASPHERE_TENANT_URL=https://your-tenant.eu10.hcs.cloud.sap
+# OAuth credentials removed for security
+```
+
+**Error logs:**
+```
+Paste relevant error logs here
+```
+
+**Additional context**
+Add any other context about the problem here.

sap_datasphere_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**SAP Datasphere context**
+- Which SAP Datasphere features would this integrate with?
+- Are there specific APIs or endpoints involved?
+- Would this require additional OAuth permissions?
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

sap_datasphere_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.8, 3.9, "3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+    
+    - name: Lint with ruff
+      run: |
+        ruff check .
+        ruff format --check .
+    
+    - name: Type check with mypy
+      run: |
+        mypy sap_datasphere_mcp
+    
+    - name: Test with pytest
+      run: |
+        pytest --cov=sap_datasphere_mcp --cov-report=xml
+    
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: true
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v3
+      with:
+        name: dist
+        path: dist/

sap_datasphere_mcp-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Create GitHub Release
+      uses: actions/create-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref }}
+        release_name: Release ${{ github.ref }}
+        draft: false
+        prerelease: false
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        twine upload dist/*

sap_datasphere_mcp-0.1.0/.gitignore

@@ -0,0 +1,105 @@
+# 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
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+.pytest_cache/
+.tox/
+.nox/
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+htmlcov/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# Environments
+.env.local
+.env.development
+.env.test
+.env.production
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Logs
+*.log
+logs/
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Credentials and secrets
+*.pem
+*.key
+secrets/
+credentials/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.bak
+
+# Documentation build
+site/
+docs/_build/

sap_datasphere_mcp-0.1.0/.pypirc

@@ -0,0 +1,13 @@
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-AgEIcHlwaS5vcmcCJDc3NjljMzYyLTU0MjgtNDQ2MC05NmI1LWVkZDcxMzk1NDA5ZQACKlszLCI2ZTdkNGMxMy0zZWNhLTRlNGItOGYzNy0zOGI5M2JkNzgzZTkiXQAABiAlddL_U7QBSHAZJzbZXndHM-bUJN93VqQg5r1m6I-QQg
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-AgEIcHlwaS5vcmcCJDc3NjljMzYyLTU0MjgtNDQ2MC05NmI1LWVkZDcxMzk1NDA5ZQACKlszLCI2ZTdkNGMxMy0zZWNhLTRlNGItOGYzNy0zOGI5M2JkNzgzZTkiXQAABiAlddL_U7QBSHAZJzbZXndHM-bUJN93VqQg5r1m6I-QQg

sap_datasphere_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to the SAP Datasphere MCP Server 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).
+
+## [Unreleased]
+
+### Added
+- Initial release of SAP Datasphere MCP Server
+- OAuth 2.0 client credentials authentication
+- Basic space management tools
+- Catalog browsing capabilities
+- Connection listing functionality
+- API endpoint discovery
+- Comprehensive error handling and logging
+- Interactive setup script
+- Example usage scripts
+- Full test suite
+
+### Features
+- `test_connection` - Test OAuth connectivity
+- `discover_endpoints` - Find available API endpoints
+- `list_spaces` - List all Datasphere spaces
+- `get_space_info` - Get detailed space information
+- `list_catalog` - Browse data catalog
+- `get_table_info` - Get table schema and metadata
+- `list_connections` - List data source connections
+
+## [0.1.0] - 2025-01-13
+
+### Added
+- Initial project structure
+- Core MCP server implementation
+- SAP Datasphere API client
+- OAuth authentication module
+- Pydantic data models
+- Configuration management
+- Development tooling setup

sap_datasphere_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SAP Datasphere MCP Server
+
+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.

sap_datasphere_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: sap-datasphere-mcp
+Version: 0.1.0
+Summary: SAP Datasphere MCP Server - AI-powered access to SAP Datasphere APIs
+Project-URL: Homepage, https://github.com/MarioDeFelipe/sap-datasphere-mcp
+Project-URL: Repository, https://github.com/MarioDeFelipe/sap-datasphere-mcp
+Project-URL: Issues, https://github.com/MarioDeFelipe/sap-datasphere-mcp/issues
+Author-email: Mario de Felipe <mario@ailien.studio>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SAP Datasphere MCP Server
+
+A Model Context Protocol (MCP) server that provides AI assistants with seamless access to SAP Datasphere APIs, enabling intelligent data exploration, catalog browsing, and space management.
+
+## Features
+
+- 🔐 **OAuth 2.0 Authentication** - Secure client credentials flow
+- 🏢 **Space Management** - List and explore Datasphere spaces
+- 📊 **Catalog Access** - Browse data models, tables, and views
+- 🔗 **Connection Management** - Manage data source connections
+- 🧠 **AI-Friendly** - Structured responses optimized for AI consumption
+- 🛡️ **Enterprise Ready** - Built for production SAP environments
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.8+
+- SAP Datasphere tenant access
+- OAuth client credentials (Client ID & Secret)
+
+### Installation
+
+#### Option 1: Install from PyPI (Recommended)
+```bash
+pip install sap-datasphere-mcp
+```
+
+#### Option 2: Install from Source
+```bash
+# Clone the repository
+git clone https://github.com/MarioDeFelipe/sap-datasphere-mcp.git
+cd sap-datasphere-mcp
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+#### Configure Credentials
+```bash
+# Interactive setup (recommended)
+python -m sap_datasphere_mcp.setup
+
+# Or manually create .env file
+cp .env.example .env
+# Edit .env with your OAuth credentials
+```
+
+### Configuration
+
+Create a `.env` file with your SAP Datasphere credentials:
+
+```env
+DATASPHERE_TENANT_URL=https://your-tenant.eu10.hcs.cloud.sap
+OAUTH_CLIENT_ID=your-client-id
+OAUTH_CLIENT_SECRET=your-client-secret
+OAUTH_TOKEN_URL=https://your-auth.authentication.eu20.hana.ondemand.com/oauth/token
+```
+
+### Usage
+
+```bash
+# Run the MCP server
+python -m sap_datasphere_mcp
+
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector python -m sap_datasphere_mcp
+```
+
+## MCP Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `list_spaces` | List all available Datasphere spaces | None |
+| `get_space_info` | Get detailed information about a space | `space_id` |
+| `list_catalog` | Browse the data catalog | `space_id` (optional) |
+| `get_table_info` | Get table schema and metadata | `space_id`, `table_name` |
+| `list_connections` | List data source connections | `space_id` (optional) |
+| `test_connection` | Test OAuth connectivity | None |
+
+## Architecture
+
+```
+sap-datasphere-mcp/
+├── sap_datasphere_mcp/
+│   ├── __init__.py
+│   ├── server.py          # Main MCP server
+│   ├── auth.py           # OAuth authentication
+│   ├── client.py         # Datasphere API client
+│   └── models.py         # Data models
+├── tests/
+├── examples/
+├── requirements.txt
+└── README.md
+```
+
+## Development
+
+```bash
+# Install development dependencies
+pip install -r requirements-dev.txt
+
+# Run tests
+pytest
+
+# Format code
+black .
+ruff check --fix .
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📖 [Documentation](docs/)
+- 🐛 [Issues](https://github.com/yourusername/sap-datasphere-mcp/issues)
+- 💬 [Discussions](https://github.com/yourusername/sap-datasphere-mcp/discussions)

sap_datasphere_mcp-0.1.0/PUBLISHING_CHECKLIST.md

@@ -0,0 +1,88 @@
+# Publishing Checklist
+
+## Pre-Publishing Setup
+
+### 1. Personal Information Needed
+- [ ] Author name
+- [ ] Author email  
+- [ ] GitHub username
+- [ ] Repository name preference
+
+### 2. Account Setup
+- [ ] GitHub account ready
+- [ ] PyPI account created (https://pypi.org/account/register/)
+- [ ] PyPI API token generated
+
+### 3. Repository Preparation
+- [ ] Update author info in pyproject.toml
+- [ ] Update GitHub URLs in pyproject.toml
+- [ ] Update README with correct GitHub links
+- [ ] Remove test credentials from code
+- [ ] Verify all files are ready
+
+## Publishing Steps
+
+### Phase 1: GitHub Repository
+```bash
+# 1. Initialize git repository
+cd sap-datasphere-mcp
+git init
+git add .
+git commit -m "Initial commit: SAP Datasphere MCP Server v0.1.0"
+
+# 2. Create GitHub repository (via GitHub web interface)
+# Repository name: sap-datasphere-mcp
+# Description: SAP Datasphere MCP Server - AI-powered access to SAP Datasphere APIs
+# Public repository
+# Initialize with README: No (we have our own)
+
+# 3. Connect and push
+git remote add origin https://github.com/[USERNAME]/sap-datasphere-mcp.git
+git branch -M main
+git push -u origin main
+```
+
+### Phase 2: PyPI Publishing
+```bash
+# 1. Install build tools
+pip install build twine
+
+# 2. Build package
+python -m build
+
+# 3. Upload to PyPI (test first)
+twine upload --repository testpypi dist/*
+
+# 4. Test installation from TestPyPI
+pip install --index-url https://test.pypi.org/simple/ sap-datasphere-mcp
+
+# 5. Upload to production PyPI
+twine upload dist/*
+```
+
+### Phase 3: Post-Publishing
+- [ ] Test installation: `pip install sap-datasphere-mcp`
+- [ ] Update README with installation instructions
+- [ ] Create first GitHub release
+- [ ] Add GitHub topics/tags
+- [ ] Share on social media/communities
+
+## Security Notes
+- [ ] Remove any hardcoded credentials
+- [ ] Add .env to .gitignore (already done)
+- [ ] Use environment variables for sensitive data
+- [ ] Set up GitHub secrets for CI/CD
+
+## Quality Checks
+- [ ] All tests pass
+- [ ] Code is properly formatted
+- [ ] Documentation is complete
+- [ ] Examples work correctly
+- [ ] License is appropriate (MIT)
+
+## Marketing/Visibility
+- [ ] Add to awesome-mcp lists
+- [ ] Post on SAP Community
+- [ ] Share on LinkedIn/Twitter
+- [ ] Add to Model Context Protocol registry
+- [ ] Create demo video/screenshots