{"_id":"@dannyboy2042/gpt5-mcp-server","_rev":"4-b52bd3909c349c25d505fdaed49d0cd8","name":"@dannyboy2042/gpt5-mcp-server","dist-tags":{"latest":"2.1.1"},"versions":{"1.0.0":{"name":"@dannyboy2042/gpt5-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","gpt-5","openai","ai","assistant","claude","anthropic"],"author":{"name":"Daniel Bowne","email":"daniel@example.com"},"license":"MIT","_id":"@dannyboy2042/gpt5-mcp-server@1.0.0","maintainers":[{"name":"dannyboy2042","email":"danielbowne@gmail.com"}],"homepage":"https://github.com/danielbowne/gpt5-mcp#readme","bugs":{"url":"https://github.com/danielbowne/gpt5-mcp/issues"},"bin":{"gpt5-mcp-server":"build/index.js"},"dist":{"shasum":"f0b23c83e500b011c5ce63c226a16f1cd653fbac","tarball":"https://registry.npmjs.org/@dannyboy2042/gpt5-mcp-server/-/gpt5-mcp-server-1.0.0.tgz","fileCount":5,"integrity":"sha512-7TIp9r0nosOR3j1jaGCb+zGxBCzwZ6ABJGpIeR1RX7KbdeDMpI5IRQY1mD7yoo5/D2pIO/ZoYQZXc21I7Hvo6Q==","signatures":[{"sig":"MEUCIQD7PDl5009V+rQhTaDCxJCprGGSG9Zut+RO6NXA48D+ogIgb0wtLkfvtAZ97vw6Ogf4fA82X6ZnsX1TBQCX0uSpFZE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20701},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"44b27d83550bf7054abbd2f2462c998e65efd076","scripts":{"dev":"tsc && node build/index.js","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","release:beta":"npm version prerelease --preid=beta && git push && git push --tags","release:major":"npm version major && git push && git push --tags","release:minor":"npm version minor && git push && git push --tags","release:patch":"npm version patch && git push && git push --tags","prepublishOnly":"npm run build"},"_npmUser":{"name":"dannyboy2042","email":"danielbowne@gmail.com"},"repository":{"url":"git+https://github.com/danielbowne/gpt5-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.8","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gpt5-mcp-server_1.0.0_1754914565710_0.1440339277862226","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@dannyboy2042/gpt5-mcp-server","version":"2.0.1","keywords":["mcp","model-context-protocol","gpt-5","openai","ai","assistant","claude","anthropic"],"author":{"name":"Daniel Bowne","email":"daniel@example.com"},"license":"MIT","_id":"@dannyboy2042/gpt5-mcp-server@2.0.1","maintainers":[{"name":"dannyboy2042","email":"danielbowne@gmail.com"}],"homepage":"https://github.com/danielbowne/gpt5-mcp#readme","bugs":{"url":"https://github.com/danielbowne/gpt5-mcp/issues"},"bin":{"gpt5-mcp-server":"build/index.js"},"dist":{"shasum":"37542298b0cb0ff2005d47a13eca2fe676a26fff","tarball":"https://registry.npmjs.org/@dannyboy2042/gpt5-mcp-server/-/gpt5-mcp-server-2.0.1.tgz","fileCount":5,"integrity":"sha512-+Rgxic3bUSqKNRSthGqQa6Z3FIYorQpR5AXJDEfQW2s+lcTGC0pJiZM7ADvr/1DF8E1XPwqcve/tVHsf4R58Vw==","signatures":[{"sig":"MEUCIQD6ZEWoTAdjmcTdP2pALFRI6ojj9Dhg7nbkl1V5ZVr0fQIgWZUX33DD6yhkD6wOw+ies+8gdabpcqmNknYFZfiGZPw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20957},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"91f6727702e412c5c465c0c8d5fa1d0203553825","scripts":{"dev":"tsc && node build/index.js","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","release:beta":"npm version prerelease --preid=beta && git push && git push --tags","release:major":"npm version major && git push && git push --tags","release:minor":"npm version minor && git push && git push --tags","release:patch":"npm version patch && git push && git push --tags","prepublishOnly":"npm run build"},"_npmUser":{"name":"dannyboy2042","email":"danielbowne@gmail.com"},"repository":{"url":"git+https://github.com/danielbowne/gpt5-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.8","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gpt5-mcp-server_2.0.1_1754915173398_0.1841970517191922","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@dannyboy2042/gpt5-mcp-server","version":"2.1.0","keywords":["mcp","model-context-protocol","gpt-5","openai","ai","assistant","claude","anthropic"],"author":{"name":"Daniel Bowne","email":"daniel@example.com"},"license":"MIT","_id":"@dannyboy2042/gpt5-mcp-server@2.1.0","maintainers":[{"name":"dannyboy2042","email":"danielbowne@gmail.com"}],"homepage":"https://github.com/danielbowne/gpt5-mcp#readme","bugs":{"url":"https://github.com/danielbowne/gpt5-mcp/issues"},"bin":{"gpt5-mcp-server":"build/index.js"},"dist":{"shasum":"140dc754fb86b4605d12cf618a647b159d6aedd8","tarball":"https://registry.npmjs.org/@dannyboy2042/gpt5-mcp-server/-/gpt5-mcp-server-2.1.0.tgz","fileCount":5,"integrity":"sha512-tqWcwHMBrIhdXm9qn6wVhEL6zAJWnk225OQh6biFjpn0RodmvT7/KtEHW2seOa02OywUaMJqzYoIrmLJMecpyg==","signatures":[{"sig":"MEUCIQCxGqeoJlLm/ys0wJVcjCGvuY4wy+5fCg1Seh7rLfG+bAIgKn5qp+hIUEPuRKrTETsLwJDQ+t4aD6LL8DbL6MLizqc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21071},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"9b5d12799976b8f3e4528e1dd336ac3cf27fd7ce","scripts":{"dev":"tsc && node build/index.js","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","release:beta":"npm version prerelease --preid=beta && git push && git push --tags","release:major":"npm version major && git push && git push --tags","release:minor":"npm version minor && git push && git push --tags","release:patch":"npm version patch && git push && git push --tags","prepublishOnly":"npm run build"},"_npmUser":{"name":"dannyboy2042","email":"danielbowne@gmail.com"},"repository":{"url":"git+https://github.com/danielbowne/gpt5-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API","directories":{},"_nodeVersion":"20.19.4","dependencies":{"zod":"^3.23.8","dotenv":"^16.3.1","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/gpt5-mcp-server_2.1.0_1754924431125_0.9198018240870578","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@dannyboy2042/gpt5-mcp-server","version":"2.1.1","description":"A Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API","type":"module","main":"build/index.js","bin":{"gpt5-mcp-server":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","dev":"tsc && node build/index.js","prepublishOnly":"npm run build","release:patch":"npm version patch && git push && git push --tags","release:minor":"npm version minor && git push && git push --tags","release:major":"npm version major && git push && git push --tags","release:beta":"npm version prerelease --preid=beta && git push && git push --tags"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","dotenv":"^16.3.1","node-fetch":"^3.3.2","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.6.0"},"keywords":["mcp","model-context-protocol","gpt-5","openai","ai","assistant","claude","anthropic"],"author":{"name":"Daniel Bowne","email":"daniel@example.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/danielbowne/gpt5-mcp.git"},"bugs":{"url":"https://github.com/danielbowne/gpt5-mcp/issues"},"homepage":"https://github.com/danielbowne/gpt5-mcp#readme","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@dannyboy2042/gpt5-mcp-server@2.1.1","gitHead":"4c09f421e70536d64cae80e4be390d6ae5ea7a30","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-z5ot+9j/1P2V9ud28d3SBmouXIT8n9JnesdvKBUxURTelsMt4vfg6jMkOKHbVE0XQRo/gMaQavZIJ04ydjEJtA==","shasum":"939cc8a1a00f5cdbfae6e65f2f2fb72fa00cf474","tarball":"https://registry.npmjs.org/@dannyboy2042/gpt5-mcp-server/-/gpt5-mcp-server-2.1.1.tgz","fileCount":5,"unpackedSize":21125,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDNt36QTiSMxursDCStilHl8Pc6MrUDl1QWj0XE6XNkIwIgCjWr55aJOmPRTOJnPQK5gY4VzXVjLqp47SyfLPPeWNc="}]},"_npmUser":{"name":"dannyboy2042","email":"danielbowne@gmail.com"},"directories":{},"maintainers":[{"name":"dannyboy2042","email":"danielbowne@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gpt5-mcp-server_2.1.1_1754924989078_0.5865869855874297"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-11T12:16:05.495Z","modified":"2025-08-11T15:09:49.432Z","1.0.0":"2025-08-11T12:16:05.904Z","2.0.1":"2025-08-11T12:26:13.637Z","2.1.0":"2025-08-11T15:00:31.433Z","2.1.1":"2025-08-11T15:09:49.257Z"},"bugs":{"url":"https://github.com/danielbowne/gpt5-mcp/issues"},"author":{"name":"Daniel Bowne","email":"daniel@example.com"},"license":"MIT","homepage":"https://github.com/danielbowne/gpt5-mcp#readme","keywords":["mcp","model-context-protocol","gpt-5","openai","ai","assistant","claude","anthropic"],"repository":{"type":"git","url":"git+https://github.com/danielbowne/gpt5-mcp.git"},"description":"A Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API","maintainers":[{"name":"dannyboy2042","email":"danielbowne@gmail.com"}],"readme":"# GPT-5 MCP Server\n\n<div align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/danielbowne/gpt5-mcp/main/assets/images/gpt5-mcp-logo.png\" alt=\"GPT-5 MCP Server Logo\" width=\"300\" />\n</div>\n\nA Model Context Protocol (MCP) server that provides seamless integration with OpenAI's GPT-5 API. Access the most advanced language model directly through your favorite AI development tools.\n\n## Features\n\n- **Direct GPT-5 Integration**: Access OpenAI's most advanced model through MCP\n- **Dual Tool Support**:\n  - `gpt5_generate`: Simple text generation with prompts\n  - `gpt5_messages`: Structured conversation handling\n- **Flexible Parameters**: Control temperature, max tokens, reasoning effort, and more\n- **Usage Tracking**: Built-in token usage reporting\n- **TypeScript**: Fully typed for better development experience\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v18 or higher)\n- OpenAI API key with GPT-5 access\n\n### Quick Start\n\n**Option 1: Install from NPM (Recommended)**\n```bash\nnpm install -g @dannyboy2042/gpt5-mcp-server\n```\n\n**Option 2: Build from Source**\n```bash\ngit clone https://github.com/danielbowne/gpt5-mcp.git\ncd gpt5-mcp/servers/gpt5-server\nnpm install\nnpm run build\n```\n\nSet your OpenAI API key:\n```bash\nexport OPENAI_API_KEY=your-api-key-here\n```\n\n## Client Configuration\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dannyboy2042/gpt5-mcp-server\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Alternative: Using local build</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5-server\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/gpt5-mcp/servers/gpt5-server/build/index.js\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n</details>\n\n### Cursor\n\nAdd to your Cursor settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dannyboy2042/gpt5-mcp-server\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to your Windsurf configuration file:\n\n**macOS**: `~/Library/Application Support/Windsurf/config.json`\n**Windows**: `%APPDATA%\\Windsurf\\config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dannyboy2042/gpt5-mcp-server\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Continue\n\nAdd to your Continue configuration:\n\n```json\n{\n  \"models\": [\n    {\n      \"model\": \"AUTODETECT\",\n      \"provider\": \"mcp\",\n      \"apiKey\": \"\",\n      \"mcpServers\": [\n        {\n          \"command\": \"npx\",\n          \"args\": [\"@dannyboy2042/gpt5-mcp-server\"],\n          \"env\": {\n            \"OPENAI_API_KEY\": \"your-api-key-here\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```\n\n### Claude Code\n\n**Local Server Connection (Recommended)**\n```bash\nclaude mcp add gpt5-server -- npx -y @dannyboy2042/gpt5-mcp-server\n```\n\n**With Environment Variable**\n```bash\nclaude mcp add gpt5-server -e OPENAI_API_KEY=your-api-key-here -- npx -y @dannyboy2042/gpt5-mcp-server\n```\n\n**Legacy Method**\n```bash\nclaude mcp add gpt5-server -e OPENAI_API_KEY=your-api-key-here -- npx @dannyboy2042/gpt5-mcp-server\n```\n\n### Generic MCP Client\n\nFor any MCP-compatible client, use:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"@dannyboy2042/gpt5-mcp-server\"],\n  \"env\": {\n    \"OPENAI_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\n## Tools\n\n### `gpt5_generate`\n\nGenerate text using a simple input prompt.\n\n**Parameters:**\n- `input` (required): The text prompt for GPT-5\n- `model` (optional): GPT-5 model variant (default: \"gpt-5\")\n- `instructions` (optional): System instructions for the model\n- `reasoning_effort` (optional): Reasoning level (\"low\", \"medium\", \"high\")\n- `max_tokens` (optional): Maximum tokens to generate\n- `temperature` (optional): Randomness level (0-2)\n- `top_p` (optional): Top-p sampling parameter (0-1)\n\n**Example:**\n```json\n{\n  \"input\": \"Explain quantum computing in simple terms\",\n  \"reasoning_effort\": \"high\",\n  \"max_tokens\": 500\n}\n```\n\n### `gpt5_messages`\n\nGenerate text using structured conversation messages.\n\n**Parameters:**\n- `messages` (required): Array of conversation messages\n  - `role`: \"user\", \"developer\", or \"assistant\"\n  - `content`: Message text\n- `model` (optional): GPT-5 model variant (default: \"gpt-5\")\n- `instructions` (optional): System instructions\n- `reasoning_effort` (optional): Reasoning level\n- `max_tokens` (optional): Maximum tokens\n- `temperature` (optional): Randomness (0-2)\n- `top_p` (optional): Top-p sampling (0-1)\n\n**Example:**\n```json\n{\n  \"messages\": [\n    {\"role\": \"user\", \"content\": \"What is the capital of France?\"},\n    {\"role\": \"assistant\", \"content\": \"The capital of France is Paris.\"},\n    {\"role\": \"user\", \"content\": \"What about Germany?\"}\n  ],\n  \"instructions\": \"Be concise and informative\",\n  \"reasoning_effort\": \"medium\"\n}\n```\n\n## Usage Examples\n\n### Simple Generation\n```\nUse GPT-5 to explain the theory of relativity\n```\n\n### Code Review\n```\nAsk GPT-5 to review this code and suggest improvements\n```\n\n### Creative Writing\n```\nHave GPT-5 write a short story about time travel\n```\n\n### Technical Analysis\n```\nUse GPT-5 with high reasoning to solve this complex algorithm problem\n```\n\n## Environment Variables\n\nCreate a `.env` file in the `servers` directory:\n\n```bash\n# Required\nOPENAI_API_KEY=your-openai-api-key-here\n\n# Optional (for development)\nDEBUG=true\n```\n\n## Development\n\n### Building from Source\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the server\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n### Project Structure\n\n```\ngpt5-mcp/\n├── servers/\n│   └── gpt5-server/\n│       ├── src/\n│       │   ├── index.ts      # Main server\n│       │   └── utils.ts      # API utilities\n│       ├── build/            # Compiled output\n│       ├── package.json\n│       └── tsconfig.json\n└── README.md\n```\n\n## Troubleshooting\n\n### Server not responding\n- Verify your OpenAI API key is valid\n- Check that you have GPT-5 access on your account\n- Ensure Node.js v18+ is installed\n\n### Build errors\n```bash\n# Clean rebuild\nrm -rf build/\nnpm install\nnpm run build\n```\n\n### API errors\n- Check your API key has sufficient credits\n- Verify GPT-5 model access\n- Review rate limits on your OpenAI account\n\n## Security\n\n- API keys are never hardcoded\n- Environment variables for sensitive data\n- Secure HTTPS communication with OpenAI\n- Error messages don't expose sensitive information\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## Acknowledgments\n\n- Built with [Model Context Protocol](https://modelcontextprotocol.io)\n- Powered by [OpenAI GPT-5](https://openai.com)\n- TypeScript SDK by [@modelcontextprotocol](https://github.com/modelcontextprotocol)\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/danielbowne/gpt5-mcp/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/danielbowne/gpt5-mcp/discussions)\n\n## Special Thanks\n\n💡 **Inspired by**: [All About AI](https://www.youtube.com/@AllAboutAI) - Thanks for the awesome content that sparked this project!\n\n---\n\n> \"The future is already here — it's just not evenly distributed.\" - William Gibson\n\n⭐ **Star this repo if you find it useful!**","readmeFilename":"README.md"}