mathematica_mcp 0.1.0__tar.gz

mathematica_mcp-0.1.0/.coderabbit.yaml

@@ -0,0 +1,204 @@
+language: en-US
+tone_instructions: "Be concise and focus on critical issues only. Do not comment on trivial matters, nitpicks, or stylistic preferences. Only flag issues that could cause bugs, security vulnerabilities, or significant maintainability problems."
+early_access: false
+enable_free_tier: true
+reviews:
+  profile: chill
+  request_changes_workflow: false
+  high_level_summary: true
+  high_level_summary_instructions: ""
+  high_level_summary_placeholder: "@coderabbitai summary"
+  high_level_summary_in_walkthrough: false
+  auto_title_placeholder: "@coderabbitai"
+  auto_title_instructions: ""
+  review_status: true
+  commit_status: true
+  fail_commit_status: false
+  collapse_walkthrough: false
+  changed_files_summary: true
+  sequence_diagrams: true
+  estimate_code_review_effort: true
+  assess_linked_issues: true
+  related_issues: true
+  related_prs: true
+  suggested_labels: true
+  labeling_instructions: []
+  auto_apply_labels: false
+  suggested_reviewers: true
+  auto_assign_reviewers: false
+  in_progress_fortune: true
+  poem: true
+  path_filters:
+    - "!uv.lock"
+    - "!coverage/**"
+    - "!dist/**"
+    - "!*.dot"
+    - "!**/__pycache__/**"
+    - "!.venv/**"
+    - "!node_modules/**"
+  path_instructions: []
+  abort_on_close: true
+  disable_cache: false
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    ignore_title_keywords: []
+    labels: []
+    drafts: false
+    base_branches: []
+    ignore_usernames: []
+  finishing_touches:
+    docstrings:
+      enabled: true
+    unit_tests:
+      enabled: true
+  pre_merge_checks:
+    docstrings:
+      mode: warning
+      threshold: 80
+    title:
+      mode: warning
+      requirements: ""
+    description:
+      mode: warning
+    issue_assessment:
+      mode: warning
+    custom_checks: []
+  tools:
+    ast-grep:
+      rule_dirs: []
+      util_dirs: []
+      essential_rules: true
+      packages: []
+    shellcheck:
+      enabled: true
+    ruff:
+      enabled: true
+    markdownlint:
+      enabled: true
+    github-checks:
+      enabled: true
+      timeout_ms: 900000
+    languagetool:
+      enabled: true
+      enabled_rules: []
+      disabled_rules: []
+      enabled_categories: []
+      disabled_categories: []
+      enabled_only: false
+      level: default
+    biome:
+      enabled: false
+    hadolint:
+      enabled: false
+    swiftlint:
+      enabled: false
+    phpstan:
+      enabled: false
+      level: default
+    phpmd:
+      enabled: false
+    phpcs:
+      enabled: false
+    golangci-lint:
+      enabled: false
+    yamllint:
+      enabled: true
+    gitleaks:
+      enabled: true
+    checkov:
+      enabled: true
+    detekt:
+      enabled: false
+    eslint:
+      enabled: false
+    flake8:
+      enabled: false
+    rubocop:
+      enabled: false
+    buf:
+      enabled: false
+    regal:
+      enabled: false
+    actionlint:
+      enabled: true
+    pmd:
+      enabled: false
+    clang:
+      enabled: false
+    cppcheck:
+      enabled: false
+    semgrep:
+      enabled: true
+    circleci:
+      enabled: false
+    clippy:
+      enabled: false
+    sqlfluff:
+      enabled: false
+    prismaLint:
+      enabled: false
+    pylint:
+      enabled: true
+    oxc:
+      enabled: false
+    shopifyThemeCheck:
+      enabled: false
+    luacheck:
+      enabled: false
+    brakeman:
+      enabled: false
+    dotenvLint:
+      enabled: true
+    htmlhint:
+      enabled: false
+    checkmake:
+      enabled: false
+    osvScanner:
+      enabled: true
+chat:
+  art: true
+  auto_reply: true
+  integrations:
+    jira:
+      usage: auto
+    linear:
+      usage: auto
+knowledge_base:
+  opt_out: false
+  web_search:
+    enabled: true
+  code_guidelines:
+    enabled: true
+    filePatterns:
+      - ".cursor/rules/general.mdc"
+      - ".cursor/rules/python.mdc"
+      - ".cursor/rules/python-testing.mdc"
+  learnings:
+    scope: auto
+  issues:
+    scope: auto
+  jira:
+    usage: auto
+    project_keys: []
+  linear:
+    usage: auto
+    team_keys: []
+  pull_requests:
+    scope: auto
+  mcp:
+    usage: auto
+    disabled_servers: []
+code_generation:
+  docstrings:
+    language: en-US
+    path_instructions:
+      - path: "src/**"
+        instructions: "Use Google-style docstrings with Args, Returns, and Raises sections. Include type information in the function signature, not the docstring."
+  unit_tests:
+    path_instructions: []
+issue_enrichment:
+  auto_enrich:
+    enabled: true
+  planning:
+    enabled: true

mathematica_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "pip" # uv and poetry use pip
+    directory: "/" # pyproject.toml is in the root directory
+    schedule:
+      interval: "weekly"

mathematica_mcp-0.1.0/.github/workflows/build.yaml

@@ -0,0 +1,80 @@
+name: CI
+on:
+  push
+  # pull_request:
+  #   branches:
+  #     - main
+  # push:
+  #   branches:
+  #     - main
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  ci:
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+        uv-version: ["latest"]
+        # Only run CI on Linux. Windows and macOS cost 2x and 10x more respectively.
+        os: [ubuntu-latest]
+        # os: [ubuntu-latest, windows-latest, macos-latest]
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        working-directory: .
+    steps:
+      - name: Checkout the repository
+        uses: actions/checkout@v4.2.0
+      - name: Free Disk Space on GitHub Actions runner
+        # Runners come with many preinstalled tools that we don't need for our build.
+        # This action removes them to free up disk space for the following steps, such as the heavy devcontainer build.
+        uses: jlumbroso/free-disk-space@v1.3.1
+        with:
+          tool-cache: false
+          android: true
+          dotnet: true
+          haskell: true
+          large-packages: true
+          docker-images: true
+          swap-storage: true
+      - name: Install uv package manager
+        uses: astral-sh/setup-uv@v5.2.2
+        with:
+          version: ${{ matrix.uv-version }}
+          enable-cache: true
+      - name: Check uv version
+        run: uv --version
+      - name: Install dependencies
+        run: uv sync
+      - name: Check installed dependencies
+        run: |
+          uv run python --version
+          uv tree
+      - name: Build the package
+        run: uv build
+      - name: Lint the package
+        run: uvx ruff check .
+      - name: Type check the package
+        run: uvx pyright .
+      - name: Run unit tests
+        # -v                verbose
+        # -m "not paid"     skip tests requiring paid API keys
+        # -p no:warnings    ignore warnings
+        # -n auto           run tests in parallel
+        run: uv run pytest -v -m "not paid" -p no:warnings -n auto --cov=mathematica_mcp --cov-report=xml
+      - name: Upload logs
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: mathematica_mcp-pytest-logs
+          path: mathematica_mcp.log
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}

mathematica_mcp-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# macOS
+.DS_store
+
+# Python
+.venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.ropeproject/
+.env
+.env.backup
+*.log
+.coverage
+coverage*
+*.dot
+codeql-custom-queries-python/
+
+# PydanticAI
+examples/
+node_modules/
+
+# reports
+reports/*.md
+reports/*.pdf
+tests/reports/*.md
+tests/reports/*.pdf
+
+# Coding agents
+CLAUDE.local.md
+.cursor/mcp.json

mathematica_mcp-0.1.0/.vscode/extensions.json

@@ -0,0 +1,38 @@
+{
+  "recommendations": [
+    // Python
+    "nicohlr.pycharm",
+    "ms-python.python",
+    "anysphere.pyright", // language server pushed by Cursor
+    "ms-python.debugpy",
+    "charliermarsh.ruff",
+    "njpwerner.autodocstring",
+    "ms-python.vscode-pylance",
+    // yaml + toml
+    "redhat.vscode-yaml",
+    "tamasfe.even-better-toml",
+    // Bash
+    "timonwong.shellcheck",
+    "mkhl.shfmt",
+    // git + GitHub Actions
+    "ivanhofer.git-assistant",
+    "GitHub.vscode-github-actions",
+    "me-dutour-mathieu.vscode-github-actions",
+    "GitHub.vscode-pull-request-github",
+    // Copilot
+    "GitHub.copilot",
+    "GitHub.copilot-chat",
+    "ms-vscode.vscode-copilot-data-analysis",
+    "AutomataLabs.copilot-mcp",
+    "CodeRabbit.coderabbit-vscode",
+    // spell checker
+    "streetsidesoftware.code-spell-checker",
+    // logging
+    "berublan.vscode-log-viewer",
+    // mermaid 
+    "bierner.markdown-mermaid",
+  ],
+  "unwantedRecommendations": [
+    "mechatroner.rainbow-csv",
+  ]
+}

mathematica_mcp-0.1.0/.vscode/mcp.json

@@ -0,0 +1,16 @@
+{
+  "servers": {
+    "context7": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp@latest"
+      ],
+      "type": "stdio"
+    },
+    "github": {
+      "type": "http",
+      "url": "https://api.githubcopilot.com/mcp/"
+    }
+  }
+}

mathematica_mcp-0.1.0/.vscode/settings.json

@@ -0,0 +1,86 @@
+{
+  "python.defaultInterpreterPath": ".venv/bin/python",
+  "editor.formatOnSave": true,
+  "editor.inlineSuggest.enabled": true,
+  "python.languageServer": "Pylance",
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true,
+  "python.testing.cwd": "${workspaceFolder}",
+  "python.testing.autoTestDiscoverOnSaveEnabled": false,
+  "python.testing.pytestArgs": [
+    "-n",
+    "auto",
+  ],
+  "autoDocstring.docstringFormat": "google",
+  "[python]": {
+    "editor.tabSize": 4,
+    "editor.defaultFormatter": "charliermarsh.ruff",
+  },
+  "github.copilot.enable": {
+    "*": true,
+    "bash": true,
+    "yaml": true,
+    "toml": true,
+    "python": true,
+    "markdown": true,
+    "plaintext": false,
+  },
+  "chat.agent.enabled": true,
+  "cSpell.enabled": true,
+  "cSpell.allowCompoundWords": true,
+  "cSpell.language": "en",
+  "cSpell.ignorePaths": [
+    "**/*.json"
+  ],
+  "cSpell.words": [
+    "iloc",
+    "logit",
+    "pytest",
+    "pylint",
+    "Nilse",
+    "isort",
+    "pycodestyle",
+    "pyupgrade",
+    "kwargs",
+    "virtualenv",
+    "venv",
+    "pycache",
+    "pyproject",
+    "xdist",
+    "pydocstyle",
+    "pydantic",
+    "asyncio",
+    "pypandoc",
+    "isinstance",
+    "mcpserver",
+    "pyright",
+    "fastmcp",
+    "wolframscript",
+    "mathematica",
+  ],
+  "cSpell.languageSettings": [
+    {
+      "languageId": "python",
+      "enabled": true,
+      "includeRegExpList": [
+        "Python Docstrings"
+      ],
+      "patterns": [
+        {
+          "name": "Python Docstrings",
+          "pattern": "^\\s*(\"\"\")[^\"\"\"]*(\"\"\")"
+        }
+      ]
+    }
+  ],
+  "shellcheck.ignorePatterns": {
+    "**/.env.example": true,
+    "**/.env": true,
+  },
+  "logViewer.watch": [
+    {
+      "title": "mathematica_mcp",
+      "pattern": "mathematica_mcp.log"
+    },
+  ],
+}

mathematica_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Lars Nilse 2025 to present
+
+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.

mathematica_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: mathematica_mcp
+Version: 0.1.0
+Summary: MCP server for WolframScript
+Author-email: Lars Nilse <l.nilse@dunelm.org.uk>
+License-File: LICENSE
+Requires-Python: <3.13,>=3.12
+Requires-Dist: fastmcp>=2.13.0.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic-settings>=2.8.1
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pylint>=3.3.4
+Requires-Dist: pyright>=1.1.404
+Requires-Dist: pytest-asyncio>=0.25.3
+Requires-Dist: pytest-cov>=6.0.0
+Requires-Dist: pytest-mock>=3.15.1
+Requires-Dist: pytest-xdist>=3.6.1
+Requires-Dist: pytest>=8.3.4
+Requires-Dist: ruff>=0.9.5
+Description-Content-Type: text/markdown
+
+# mathematica_mcp

mathematica_mcp-0.1.0/README.md

@@ -0,0 +1 @@
+# mathematica_mcp

mathematica_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,121 @@
+[project]
+name = "mathematica_mcp"
+version = "0.1.0"
+description = "MCP server for WolframScript"
+readme = "README.md"
+authors = [{ name = "Lars Nilse", email = "l.nilse@dunelm.org.uk" }]
+requires-python = ">=3.12,<3.13"
+dependencies = [
+  "loguru>=0.7.3",
+  "pytest>=8.3.4",
+  "ruff>=0.9.5",
+  "pylint>=3.3.4",
+  "pytest-xdist>=3.6.1",
+  "pytest-cov>=6.0.0",
+  "pydantic>=2.10.6",
+  "pytest-asyncio>=0.25.3",
+  "pydantic-settings>=2.8.1",
+  "pyright>=1.1.404",
+  "pytest-mock>=3.15.1",
+  "fastmcp>=2.13.0.1",
+]
+
+[project.scripts]
+wolframscript_server = "mathematica_mcp.server:wolframscript_server"
+
+[tool.ruff]
+line-length = 150
+lint.select = [
+  "E",   # pycodestyle
+  "F",   # pyflakes
+  "I",   # isort
+  "TID", # tidy imports
+  "UP",  # pyupgrade
+  "C4",  # comprehensions
+  "SIM", # simplifications
+  "PD",  # pandas-specific rules
+  "NPY", # numpy-specific rules
+  "PL",  # pylint
+  "B",   # bugbear
+  "ANN", # type annotations
+  "TC",  # type checking
+]
+lint.ignore = [
+  "SIM108",  # Ignore ternary operators rule i.e. allow if-else blocks
+  "PLR2004", # Allow magic values
+  "PLR0915", # Allow long functions
+  "PLR0912", # Allow many branches
+  "PLR0913", # Allow many arguments
+  "TC006",   # Allow type casting without strings
+]
+lint.pydocstyle.convention = "google"
+
+[tool.pyright]
+# Core Settings
+typeCheckingMode = "basic"  # next step: "standard"
+pythonVersion = "3.12"
+venvPath = "."
+venv = ".venv"
+# Paths
+include = ["src", "tests"]
+exclude = [
+  ".git",
+  ".venv",
+  "dist",
+  "uml",
+  "**/__pycache__",
+]
+strict = []  # If you really really want strict checking for parts of the code
+# High-value Rules
+reportOptionalMemberAccess = "error"
+reportOptionalSubscript = "error"  
+reportOptionalCall = "error"
+reportGeneralTypeIssues = "error"
+reportReturnType = "error"
+# Grey Area
+reportAttributeAccessIssue = "warning"
+# Noisy Rules
+reportUnknownParameterType = false
+reportUnknownVariableType = false
+reportMissingParameterType = false
+reportMissingTypeStubs = false
+reportPrivateUsage = false
+
+[tool.pytest.ini_options]
+addopts = ["-m", "not paid"] # Skip tests that require a paid API key
+asyncio_default_fixture_loop_scope = "function" # Use "session" for a single event loop for all tests or "function" for a new event loop for every test (more isolation).
+markers = [
+  "wolframscript: tests requiring a local WolframScript installation",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["mathematica_mcp"]
+parallel = true
+disable_warnings = ["module-not-measured"]
+omit = [
+  "tests/*",
+  "src/mathematica_mcp/server.py",
+]
+
+[tool.coverage.report]
+show_missing = true  # Show line numbers of missing coverage in terminal
+skip_covered = false # Show all files, including those with full coverage
+skip_empty = true    # Skip files with no statements
+precision = 1        # Show coverage to 1 decimal place
+exclude_lines = [
+    "pragma: no cover",            # Don't count lines marked to be excluded
+    "raise NotImplementedError",   # Don't count abstract methods
+    "if __name__ == .__main__.:",  # Don't count main entry points
+    "if TYPE_CHECKING:",           # Don't count type checking blocks
+]
+
+[tool.coverage.html]
+directory = "coverage"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mathematica_mcp"]

mathematica_mcp-0.1.0/src/mathematica_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""mathematica_mcp public interface"""
+
+__all__ = []

mathematica_mcp-0.1.0/src/mathematica_mcp/logger.py

@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+
+from loguru import logger
+
+__all__ = ["logger"]
+
+# Configure Loguru
+logger.remove(0)  # Remove default console logger
+logger.add(
+    __name__.split(".")[0] + ".log",
+    rotation="500 MB",
+    level="DEBUG",
+)