claude-gpt 0.1.0__tar.gz

claude_gpt-0.1.0/.env.example

@@ -0,0 +1,23 @@
+# Development-only overrides. Copy to .env in the project directory.
+# Environment variables beat ~/.claude-gpt/config.toml, which beats this file.
+# Do not put the real API key here in a shared checkout; prefer ~/.claude-gpt/config.toml (mode 600).
+
+# OPENAI_API_KEY=sk-...
+CLAUDE_GPT_ENGINE=openai               # openai | fake (canned replies, no network)
+CLAUDE_GPT_MODEL=astra                 # astra | sol | terra | luna, or a model ID
+# CLAUDE_GPT_STATE_DIR=~/.claude-gpt
+# CLAUDE_GPT_OUTPUT_ROOT=~/ClaudeGPT
+# CLAUDE_GPT_ALLOWED_ROOTS=~           # colon-separated
+# CLAUDE_GPT_DASHBOARD_HOST=127.0.0.1
+# CLAUDE_GPT_DASHBOARD_PORT=8765
+# CLAUDE_GPT_DEFAULT_WEB_SEARCH=false
+# CLAUDE_GPT_DEFAULT_CODE_INTERPRETER=true
+# CLAUDE_GPT_DEFAULT_REASONING_EFFORT=high
+# CLAUDE_GPT_DEFAULT_OUTPUT_MODE=auto
+# CLAUDE_GPT_INLINE_MAX_WORDS=700
+# CLAUDE_GPT_MAX_CONCURRENT_JOBS=3
+# CLAUDE_GPT_MAX_FILE_MB=100
+# CLAUDE_GPT_SESSION_BUDGET_USD=25
+# CLAUDE_GPT_DAILY_BUDGET_USD=100
+# CLAUDE_GPT_LOG_LEVEL=INFO
+# CLAUDE_GPT_FAKE_DELAY_SECONDS=3

claude_gpt-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.env
+dist/
+build/
+*.egg-info/
+.DS_Store
+.venv.nosync/
+
+# Secrets: the live key lives in ~/.claude-gpt/config.toml (outside this folder); never commit a copy
+config.toml
+*.local.toml
+.claude-gpt/

claude_gpt-0.1.0/LICENSE

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

claude_gpt-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.5
+Name: claude-gpt
+Version: 0.1.0
+Summary: MCP server that lets Claude Desktop delegate heavy work to OpenAI models: persistent sessions, file attachments, background jobs, live dashboard, cost tracking.
+Project-URL: Homepage, https://github.com/karlfoster/claude-gpt
+Project-URL: Repository, https://github.com/karlfoster/claude-gpt
+Project-URL: Issues, https://github.com/karlfoster/claude-gpt/issues
+Author: Karl Foster
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,chatgpt,claude,claude-desktop,delegation,gpt-6,mcp,openai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.10
+Requires-Dist: jinja2>=3.1
+Requires-Dist: mammoth>=1.9
+Requires-Dist: mcp>=2.1
+Requires-Dist: openai>=3.8
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pillow-heif>=0.20
+Requires-Dist: pillow>=11
+Requires-Dist: pypdf>=5
+Requires-Dist: python-pptx>=1.0
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-job.png" alt="Claude GPT dashboard showing a research job with its reasoning, searches and rendered result" width="900">
+</p>
+
+<h1 align="center">Claude GPT</h1>
+
+<p align="center">
+  Hand heavy work from Claude Desktop to OpenAI's frontier models and get the result back in the same chat.<br>
+  Persistent sessions, real file attachments, background jobs that survive restarts, a live dashboard, and cost tracking.
+</p>
+
+<p align="center">
+  <a href="https://github.com/karlfoster/claude-gpt/actions/workflows/ci.yml"><img src="https://github.com/karlfoster/claude-gpt/actions/workflows/ci.yml/badge.svg" alt="Tests"></a>
+  <img src="https://img.shields.io/badge/platform-macOS-lightgrey" alt="macOS only">
+  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
+  <img src="https://img.shields.io/badge/licence-MIT-green" alt="MIT licence">
+</p>
+
+---
+
+Claude stays in charge. It holds your files, skills and memory, decides what needs heavy lifting, hands that work to GPT-6 Astra (or GPT-5.6 Sol) with the right brief and attachments, and relays the answer. You say things like:
+
+> "Hand ~/Downloads/board-pack.pdf to ChatGPT and ask it for a summary with the key figures."
+
+> "Give the deck and the brand guidelines to ChatGPT and have it rewrite the narrative."
+
+> "Is ChatGPT done?"
+
+Claude calls the bridge's tools; the model works in the background on OpenAI's side; short answers come straight back into the chat, long ones land on disk with a preview, and charts appear as images.
+
+## Why
+
+- **Overflow.** When Claude credits run low on a heavy day, the same chat can delegate to another frontier model without copy-pasting between apps.
+- **Cheap orchestrator, expensive engine.** Run a lighter Claude model for the conversation and still get frontier-quality output on the delegated parts.
+- **Whole documents, not pasted text.** Decks, spreadsheets, PDFs and images reach the model as files. The tools refuse pasted contents, so nothing gets lost in extraction.
+- **No timeouts, no lost work.** Every tool call returns in seconds. Jobs run on OpenAI's side in background mode with a stored cursor, so a restart of Claude Desktop, or of your Mac, resumes rather than restarts.
+- **Watch it think.** The dashboard streams reasoning summaries, web searches, code execution and output as they happen.
+
+## Quick start
+
+macOS only for now. You need [uv](https://docs.astral.sh/uv/), an OpenAI API key (a project key with a monthly budget is wise) and, for pptx and docx attachments, LibreOffice.
+
+```bash
+uv tool install git+https://github.com/karlfoster/claude-gpt   # or: uv tool install claude-gpt, once on PyPI
+claude-gpt set-key                                             # prompts for the key; stored privately, never echoed
+claude-gpt setup --register                                    # checks the key and LibreOffice, registers in Claude Desktop
+```
+
+Restart Claude Desktop and the seven `chatgpt_*` tools appear. Optional: `brew install --cask libreoffice`.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/cli-setup.png" alt="The setup command in a terminal" width="760">
+</p>
+
+Working from a clone instead? `uv sync` then `uv run claude-gpt setup --register`. The [design notes](docs/DESIGN.md) explain why registration points at the interpreter rather than `uv run`.
+
+## What you can do
+
+| Ask Claude | What happens |
+|---|---|
+| "Hand this PDF to ChatGPT for a summary" | A session starts, the file is uploaded whole, the summary comes back inline |
+| "Attach the 20,000-row workbook and ask for revenue by month with a chart" | The sheet is previewed as tables and uploaded for Python; the chart returns as an image and a file |
+| "Research the Gulf basketball market with web search" | Searches stream on the dashboard; a 1,200-word briefing lands on disk with a preview |
+| "Send the changed files back for a second look" | The same session continues with the earlier context cached |
+| "Fork the session, focusing on pricing" | A summary seeds a fresh session and the old one is archived |
+| "Cancel that" or "close the session" | Immediate, from Claude or from the dashboard |
+
+Before the first call of a session Claude asks which reasoning level you want (low, medium, high, xhigh or max) and reports the level used in every reply. Change it on any turn.
+
+## Tools
+
+Seven MCP tools, all returning within seconds, all answering with plain JSON that any Claude model can follow:
+
+`chatgpt_start` creates a session with a brief and attachments · `chatgpt_send` sends a turn · `chatgpt_status` collects the result, waiting up to 45 seconds · `chatgpt_list` shows sessions, spend and the dashboard URL · `chatgpt_fork` carries a summary into a fresh session · `chatgpt_cancel` stops a job · `chatgpt_close` archives a session.
+
+## Attachments
+
+| Type | What the model receives |
+|---|---|
+| pdf | The file itself |
+| pptx, docx | Converted to PDF with LibreOffice, plus the speaker notes as text |
+| xlsx, xlsm, csv, tsv | Each sheet as a capped Markdown table; over the cap, the whole file is uploaded for Python analysis |
+| png, jpg, gif, webp, heic | Resized and sent inline as an image |
+| md, txt, json, yaml, xml, html and source code | Sent as fenced text, truncated only past 200,000 characters |
+
+Files are deduplicated by content hash across sessions, and the same file is never attached twice to one conversation. In a Cowork session, where Claude works inside a sandbox, upload paths such as `/mnt/user-data/uploads/deck.pptx` are matched to the copy on your Mac by name, and every response says which file was used.
+
+## Dashboard
+
+`http://127.0.0.1:8765` while the server runs. Home shows every session with status, turns and spend, plus today's and the last 30 days' totals. A session page lists its brief, attached files and jobs, with close and fork buttons. A job page streams the activity live and renders the result as Markdown when it finishes, with generated files and image previews. It recovers after a browser refresh mid-job.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-home.png" alt="Dashboard home listing sessions" width="900">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-session.png" alt="A session page with attached files and jobs" width="900">
+</p>
+
+## Models, costs and budgets
+
+GPT-6 Astra is the default; Sol, Terra and Luna are a `model: "sol"` away per session. Costs are computed per job from an editable price table (checked against OpenAI's pricing page on 4 September 2026), rolled up per session and per day, and shown in every status reply and on the dashboard. A session budget ($25) and a daily budget ($100) refuse new jobs when exceeded; Claude can override per call when you say so.
+
+## Configuration
+
+Precedence: environment variables, then `~/.claude-gpt/config.toml`, then a project `.env`, then defaults. The first run writes a private `config.toml` with every setting commented out; `claude-gpt set-key` fills in the key.
+
+| Setting | Default | Purpose |
+|---|---|---|
+| `CLAUDE_GPT_MODEL` | `astra` | Model alias or ID for new sessions |
+| `CLAUDE_GPT_DEFAULT_REASONING_EFFORT` | `high` | Default reasoning level |
+| `CLAUDE_GPT_DEFAULT_WEB_SEARCH` | `false` | Web search on by default |
+| `CLAUDE_GPT_DEFAULT_CODE_INTERPRETER` | `true` | Code interpreter on by default |
+| `CLAUDE_GPT_INLINE_MAX_WORDS` | `700` | Longer results go to disk |
+| `CLAUDE_GPT_SESSION_BUDGET_USD` | `25` | Per-session guardrail |
+| `CLAUDE_GPT_DAILY_BUDGET_USD` | `100` | Daily guardrail across sessions |
+| `CLAUDE_GPT_OUTPUT_ROOT` | `~/ClaudeGPT` | Where results are written |
+
+Every setting is listed in `.env.example` and `config.example.toml`.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `claude-gpt` | Serve MCP over stdio (what Claude Desktop launches) |
+| `claude-gpt set-key [--from-env]` | Store the OpenAI API key privately |
+| `claude-gpt setup [--register]` | Check the key online, check LibreOffice, register in Claude Desktop |
+| `claude-gpt check-config` | Validate the configuration and show where each value came from |
+| `claude-gpt purge-uploads` | Delete every cached OpenAI file upload |
+| `claude-gpt prune --days 30` | Delete old per-job event logs |
+
+## Security and privacy
+
+- Attachments are uploaded to OpenAI under your API key and are subject to OpenAI's data policies; background mode stores response data on their side for a limited time.
+- The key lives in `~/.claude-gpt/config.toml`, readable only by your user, and is redacted from logs. The state directory and database are private to your user.
+- The dashboard binds to 127.0.0.1 only. File reads are confined to your home folder by default (`CLAUDE_GPT_ALLOWED_ROOTS`), symlinks are resolved before the check, and the model gets no tool that acts on your Mac.
+
+## Under the hood
+
+Python 3.12, the official MCP SDK over stdio, the OpenAI Responses API with Conversations for server-side state and background streaming with a resumable cursor, SQLite in WAL mode for the registry, JSONL event logs per job, and aiohttp for the dashboard. Two copies of the server can share one registry safely: Claude Desktop starts a second copy for its Cowork and Code sessions, so every state change is an atomic, conditional write and one active job per session is a database invariant. The [design notes](docs/DESIGN.md) cover the reasoning, the recovery model and the verification history.
+
+```bash
+uv sync && uv run pytest    # 102 tests, no network calls
+```
+
+## Licence
+
+MIT. Built by Karl Foster with Claude.

claude_gpt-0.1.0/README.md

@@ -0,0 +1,148 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-job.png" alt="Claude GPT dashboard showing a research job with its reasoning, searches and rendered result" width="900">
+</p>
+
+<h1 align="center">Claude GPT</h1>
+
+<p align="center">
+  Hand heavy work from Claude Desktop to OpenAI's frontier models and get the result back in the same chat.<br>
+  Persistent sessions, real file attachments, background jobs that survive restarts, a live dashboard, and cost tracking.
+</p>
+
+<p align="center">
+  <a href="https://github.com/karlfoster/claude-gpt/actions/workflows/ci.yml"><img src="https://github.com/karlfoster/claude-gpt/actions/workflows/ci.yml/badge.svg" alt="Tests"></a>
+  <img src="https://img.shields.io/badge/platform-macOS-lightgrey" alt="macOS only">
+  <img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="Python 3.12+">
+  <img src="https://img.shields.io/badge/licence-MIT-green" alt="MIT licence">
+</p>
+
+---
+
+Claude stays in charge. It holds your files, skills and memory, decides what needs heavy lifting, hands that work to GPT-6 Astra (or GPT-5.6 Sol) with the right brief and attachments, and relays the answer. You say things like:
+
+> "Hand ~/Downloads/board-pack.pdf to ChatGPT and ask it for a summary with the key figures."
+
+> "Give the deck and the brand guidelines to ChatGPT and have it rewrite the narrative."
+
+> "Is ChatGPT done?"
+
+Claude calls the bridge's tools; the model works in the background on OpenAI's side; short answers come straight back into the chat, long ones land on disk with a preview, and charts appear as images.
+
+## Why
+
+- **Overflow.** When Claude credits run low on a heavy day, the same chat can delegate to another frontier model without copy-pasting between apps.
+- **Cheap orchestrator, expensive engine.** Run a lighter Claude model for the conversation and still get frontier-quality output on the delegated parts.
+- **Whole documents, not pasted text.** Decks, spreadsheets, PDFs and images reach the model as files. The tools refuse pasted contents, so nothing gets lost in extraction.
+- **No timeouts, no lost work.** Every tool call returns in seconds. Jobs run on OpenAI's side in background mode with a stored cursor, so a restart of Claude Desktop, or of your Mac, resumes rather than restarts.
+- **Watch it think.** The dashboard streams reasoning summaries, web searches, code execution and output as they happen.
+
+## Quick start
+
+macOS only for now. You need [uv](https://docs.astral.sh/uv/), an OpenAI API key (a project key with a monthly budget is wise) and, for pptx and docx attachments, LibreOffice.
+
+```bash
+uv tool install git+https://github.com/karlfoster/claude-gpt   # or: uv tool install claude-gpt, once on PyPI
+claude-gpt set-key                                             # prompts for the key; stored privately, never echoed
+claude-gpt setup --register                                    # checks the key and LibreOffice, registers in Claude Desktop
+```
+
+Restart Claude Desktop and the seven `chatgpt_*` tools appear. Optional: `brew install --cask libreoffice`.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/cli-setup.png" alt="The setup command in a terminal" width="760">
+</p>
+
+Working from a clone instead? `uv sync` then `uv run claude-gpt setup --register`. The [design notes](docs/DESIGN.md) explain why registration points at the interpreter rather than `uv run`.
+
+## What you can do
+
+| Ask Claude | What happens |
+|---|---|
+| "Hand this PDF to ChatGPT for a summary" | A session starts, the file is uploaded whole, the summary comes back inline |
+| "Attach the 20,000-row workbook and ask for revenue by month with a chart" | The sheet is previewed as tables and uploaded for Python; the chart returns as an image and a file |
+| "Research the Gulf basketball market with web search" | Searches stream on the dashboard; a 1,200-word briefing lands on disk with a preview |
+| "Send the changed files back for a second look" | The same session continues with the earlier context cached |
+| "Fork the session, focusing on pricing" | A summary seeds a fresh session and the old one is archived |
+| "Cancel that" or "close the session" | Immediate, from Claude or from the dashboard |
+
+Before the first call of a session Claude asks which reasoning level you want (low, medium, high, xhigh or max) and reports the level used in every reply. Change it on any turn.
+
+## Tools
+
+Seven MCP tools, all returning within seconds, all answering with plain JSON that any Claude model can follow:
+
+`chatgpt_start` creates a session with a brief and attachments · `chatgpt_send` sends a turn · `chatgpt_status` collects the result, waiting up to 45 seconds · `chatgpt_list` shows sessions, spend and the dashboard URL · `chatgpt_fork` carries a summary into a fresh session · `chatgpt_cancel` stops a job · `chatgpt_close` archives a session.
+
+## Attachments
+
+| Type | What the model receives |
+|---|---|
+| pdf | The file itself |
+| pptx, docx | Converted to PDF with LibreOffice, plus the speaker notes as text |
+| xlsx, xlsm, csv, tsv | Each sheet as a capped Markdown table; over the cap, the whole file is uploaded for Python analysis |
+| png, jpg, gif, webp, heic | Resized and sent inline as an image |
+| md, txt, json, yaml, xml, html and source code | Sent as fenced text, truncated only past 200,000 characters |
+
+Files are deduplicated by content hash across sessions, and the same file is never attached twice to one conversation. In a Cowork session, where Claude works inside a sandbox, upload paths such as `/mnt/user-data/uploads/deck.pptx` are matched to the copy on your Mac by name, and every response says which file was used.
+
+## Dashboard
+
+`http://127.0.0.1:8765` while the server runs. Home shows every session with status, turns and spend, plus today's and the last 30 days' totals. A session page lists its brief, attached files and jobs, with close and fork buttons. A job page streams the activity live and renders the result as Markdown when it finishes, with generated files and image previews. It recovers after a browser refresh mid-job.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-home.png" alt="Dashboard home listing sessions" width="900">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/karlfoster/claude-gpt/main/docs/screenshots/dashboard-session.png" alt="A session page with attached files and jobs" width="900">
+</p>
+
+## Models, costs and budgets
+
+GPT-6 Astra is the default; Sol, Terra and Luna are a `model: "sol"` away per session. Costs are computed per job from an editable price table (checked against OpenAI's pricing page on 4 September 2026), rolled up per session and per day, and shown in every status reply and on the dashboard. A session budget ($25) and a daily budget ($100) refuse new jobs when exceeded; Claude can override per call when you say so.
+
+## Configuration
+
+Precedence: environment variables, then `~/.claude-gpt/config.toml`, then a project `.env`, then defaults. The first run writes a private `config.toml` with every setting commented out; `claude-gpt set-key` fills in the key.
+
+| Setting | Default | Purpose |
+|---|---|---|
+| `CLAUDE_GPT_MODEL` | `astra` | Model alias or ID for new sessions |
+| `CLAUDE_GPT_DEFAULT_REASONING_EFFORT` | `high` | Default reasoning level |
+| `CLAUDE_GPT_DEFAULT_WEB_SEARCH` | `false` | Web search on by default |
+| `CLAUDE_GPT_DEFAULT_CODE_INTERPRETER` | `true` | Code interpreter on by default |
+| `CLAUDE_GPT_INLINE_MAX_WORDS` | `700` | Longer results go to disk |
+| `CLAUDE_GPT_SESSION_BUDGET_USD` | `25` | Per-session guardrail |
+| `CLAUDE_GPT_DAILY_BUDGET_USD` | `100` | Daily guardrail across sessions |
+| `CLAUDE_GPT_OUTPUT_ROOT` | `~/ClaudeGPT` | Where results are written |
+
+Every setting is listed in `.env.example` and `config.example.toml`.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `claude-gpt` | Serve MCP over stdio (what Claude Desktop launches) |
+| `claude-gpt set-key [--from-env]` | Store the OpenAI API key privately |
+| `claude-gpt setup [--register]` | Check the key online, check LibreOffice, register in Claude Desktop |
+| `claude-gpt check-config` | Validate the configuration and show where each value came from |
+| `claude-gpt purge-uploads` | Delete every cached OpenAI file upload |
+| `claude-gpt prune --days 30` | Delete old per-job event logs |
+
+## Security and privacy
+
+- Attachments are uploaded to OpenAI under your API key and are subject to OpenAI's data policies; background mode stores response data on their side for a limited time.
+- The key lives in `~/.claude-gpt/config.toml`, readable only by your user, and is redacted from logs. The state directory and database are private to your user.
+- The dashboard binds to 127.0.0.1 only. File reads are confined to your home folder by default (`CLAUDE_GPT_ALLOWED_ROOTS`), symlinks are resolved before the check, and the model gets no tool that acts on your Mac.
+
+## Under the hood
+
+Python 3.12, the official MCP SDK over stdio, the OpenAI Responses API with Conversations for server-side state and background streaming with a resumable cursor, SQLite in WAL mode for the registry, JSONL event logs per job, and aiohttp for the dashboard. Two copies of the server can share one registry safely: Claude Desktop starts a second copy for its Cowork and Code sessions, so every state change is an atomic, conditional write and one active job per session is a database invariant. The [design notes](docs/DESIGN.md) cover the reasoning, the recovery model and the verification history.
+
+```bash
+uv sync && uv run pytest    # 102 tests, no network calls
+```
+
+## Licence
+
+MIT. Built by Karl Foster with Claude.

claude_gpt-0.1.0/config.example.toml

@@ -0,0 +1,63 @@
+# Claude GPT configuration.
+# Environment variables take precedence over this file. Keys under [settings] use the
+# environment variable name without the CLAUDE_GPT_ prefix, in lower case.
+# Keep this file private (mode 600): it is the recommended home for the API key.
+
+[settings]
+# openai_api_key = "sk-..."
+# engine = "openai"            # "fake" gives canned replies without any network calls
+# background = true            # background mode makes jobs resumable after a restart
+# model = "astra"           # astra | sol | terra | luna, or a model ID
+# default_web_search = false
+# default_code_interpreter = true
+# default_reasoning_effort = "high"
+# default_output_mode = "auto"
+# inline_max_words = 700
+# max_concurrent_jobs = 3
+# session_budget_usd = 25
+# daily_budget_usd = 100
+# log_level = "INFO"
+
+[models.aliases]
+sol = "gpt-5.6-sol"        # confirmed against the models endpoint on 4 September 2026
+terra = "gpt-5.6-terra"
+luna = "gpt-5.6-luna"
+astra = "gpt-6-astra"      # listed on the pricing page; API access is rolling out
+
+# Prices per million tokens, checked against https://developers.openai.com/api/docs/pricing on
+# 4 September 2026 (standard tier, short context). Re-check when OpenAI changes them; Sol's
+# figures are promotional until at least 21 November 2026. Reasoning tokens are billed as output.
+
+[prices.models."gpt-6-astra"]
+input_per_m = 10.00
+cached_input_per_m = 1.00
+cache_write_per_m = 12.50
+output_per_m = 50.00
+
+[prices.models."gpt-5.6-sol"]
+input_per_m = 4.00
+cached_input_per_m = 0.40
+cache_write_per_m = 5.00
+output_per_m = 20.00
+
+[prices.models."gpt-5.6-terra"]
+input_per_m = 2.00
+cached_input_per_m = 0.20
+cache_write_per_m = 2.50
+output_per_m = 12.00
+
+[prices.models."gpt-5.6-luna"]
+input_per_m = 0.20
+cached_input_per_m = 0.02
+cache_write_per_m = 0.25
+output_per_m = 1.20
+
+[prices.tools]
+web_search_per_call = 0.01           # $10 per 1,000 calls
+code_interpreter_per_session = 0.03  # 1 GB container per 20-minute session
+
+[prices.multipliers]
+long_context_threshold_tokens = 272000
+long_context_input_multiplier = 2.0   # input and cached input double above the threshold
+long_context_output_multiplier = 1.5  # output is 1.5x above the threshold
+fast_mode_multiplier = 2.0            # service_tier "fast" (formerly priority)

claude_gpt-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[project]
+name = "claude-gpt"
+version = "0.1.0"
+description = "MCP server that lets Claude Desktop delegate heavy work to OpenAI models: persistent sessions, file attachments, background jobs, live dashboard, cost tracking."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Karl Foster" }]
+keywords = ["mcp", "claude", "claude-desktop", "openai", "chatgpt", "gpt-6", "delegation", "agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: MacOS X",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "mcp>=2.1",
+    "aiohttp>=3.10",
+    "jinja2>=3.1",
+    "openai>=3.8",
+    "pillow>=11",
+    "pillow-heif>=0.20",
+    "pypdf>=5",
+    "python-pptx>=1.0",
+    "openpyxl>=3.1",
+    "mammoth>=1.9",
+]
+
+[project.urls]
+Homepage = "https://github.com/karlfoster/claude-gpt"
+Repository = "https://github.com/karlfoster/claude-gpt"
+Issues = "https://github.com/karlfoster/claude-gpt/issues"
+
+[project.scripts]
+claude-gpt = "claude_gpt.__main__:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3",
+    "pytest-asyncio>=0.24",
+    "python-docx>=1.2.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/claude_gpt"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "LICENSE", "config.example.toml", ".env.example", "pyproject.toml"]
+exclude = ["tests/fixtures/*.heic"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+addopts = "-q"

claude_gpt-0.1.0/src/claude_gpt/__init__.py

@@ -0,0 +1,3 @@
+"""Claude GPT: an MCP server that lets Claude Desktop delegate work to OpenAI models."""
+
+__version__ = "0.1.0"