{"_id":"@boseong/mcp-openai-gpt5","_rev":"2-b1b09cdca8b953eea149e2ca5ec15dc8","name":"@boseong/mcp-openai-gpt5","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@boseong/mcp-openai-gpt5","version":"1.0.0","keywords":["mcp","model-context-protocol","gpt5","openai","claude","ai"],"author":{"name":"boseong"},"license":"MIT","_id":"@boseong/mcp-openai-gpt5@1.0.0","maintainers":[{"name":"boseong","email":"a31829660@gmail.com"}],"homepage":"https://github.com/boseong/mcp-servers/tree/main/server/gpt5-server#readme","bugs":{"url":"https://github.com/boseong/mcp-servers/issues"},"bin":{"mcp-openai-gpt5":"dist/index.js"},"dist":{"shasum":"870c35a3ebcedabc85aca7613675a1ff98817a15","tarball":"https://registry.npmjs.org/@boseong/mcp-openai-gpt5/-/mcp-openai-gpt5-1.0.0.tgz","fileCount":5,"integrity":"sha512-2H1ff7wJ60+y0qQn65Dg5dirOhDAlDW3M5vo/SVhLG045I02Ft3bkBbpYfaPphkqxNzIpdVhPK85M0FQZjel6A==","signatures":[{"sig":"MEUCIQCwz6SpNYOw8C1tj1lPYAK+FxLRjIYmSuDCBBlc8QfC9wIgMG0gn9vn4wb2z+PgQKUGFGSDrqNHYV/SRClzQiFfGDY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18736},"main":"dist/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod +x dist/index.js","clean":"rm -rf dist","start":"node dist/index.js","deploy":"npm run rebuild && npm publish --access public","rebuild":"npm run clean && npm run build","deploy:dry":"npm run rebuild && npm publish --dry-run --access public","release:major":"npm run version:major && npm run deploy","release:minor":"npm run version:minor && npm run deploy","release:patch":"npm run version:patch && npm run deploy","version:major":"npm version major","version:minor":"npm version minor","version:patch":"npm version patch","prepublishOnly":"npm run rebuild"},"_npmUser":{"name":"boseong","email":"a31829660@gmail.com"},"repository":{"url":"git+https://github.com/boseong/mcp-servers.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP server for OpenAI GPT-5 API with dual interface support (simple + messages)","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.22.4","dotenv":"^16.3.1","node-fetch":"^3.3.2","zod-to-json-schema":"^3.22.1","@modelcontextprotocol/sdk":"0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.2","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-openai-gpt5_1.0.0_1755067755638_0.4775088522545363","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@boseong/mcp-openai-gpt5","version":"1.1.0","description":"MCP server for OpenAI GPT-5 API with dual interface support (simple + messages)","type":"module","main":"dist/index.js","bin":{"mcp-openai-gpt5":"dist/index.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node dist/index.js","build":"tsc && chmod +x dist/index.js","clean":"rm -rf dist","rebuild":"npm run clean && npm run build","prepublishOnly":"npm run rebuild","deploy":"npm run rebuild && npm publish --access public","deploy:dry":"npm run rebuild && npm publish --dry-run --access public","version:patch":"npm version patch","version:minor":"npm version minor","version:major":"npm version major","release:patch":"npm run version:patch && npm run deploy","release:minor":"npm run version:minor && npm run deploy","release:major":"npm run version:major && npm run deploy"},"author":{"name":"boseong"},"license":"MIT","engines":{"node":">=18.0.0"},"keywords":["mcp","model-context-protocol","gpt5","gpt-5","openai","claude","ai","openai-gpt5"],"repository":{"type":"git","url":"git+https://github.com/boseong/mcp-servers.git"},"homepage":"https://github.com/boseong/mcp-servers/tree/main/server/gpt5-server#readme","bugs":{"url":"https://github.com/boseong/mcp-servers/issues"},"dependencies":{"@modelcontextprotocol/sdk":"0.6.0","dotenv":"^16.3.1","node-fetch":"^3.3.2","zod":"^3.22.4","zod-to-json-schema":"^3.22.1"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.2"},"_id":"@boseong/mcp-openai-gpt5@1.1.0","gitHead":"15be3081cdcbcd1274d3856e5d41626fb79ef5ef","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-l1Ti+GMgp2ou8MVHkjQzhIXliP9ch1ZoXhgJmTfmmgXr6auAKvODABoD3TBhAXqge+NaW5I+GD1vc4eIELxChQ==","shasum":"3649f245cb48d516c83bc776114dd666321ce43a","tarball":"https://registry.npmjs.org/@boseong/mcp-openai-gpt5/-/mcp-openai-gpt5-1.1.0.tgz","fileCount":5,"unpackedSize":19639,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCGZg/jy7Fi9ijVXikXeAyM9f/4lWmE55PrQ5Jo9Op17QIhAKrEjfstFQjsiTGorQMTIPwF0p7cw8p04TrOaPWLGj4H"}]},"_npmUser":{"name":"boseong","email":"a31829660@gmail.com"},"directories":{},"maintainers":[{"name":"boseong","email":"a31829660@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-openai-gpt5_1.1.0_1755231556319_0.08489223449550076"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-13T06:49:15.566Z","modified":"2025-08-15T04:19:16.676Z","1.0.0":"2025-08-13T06:49:15.822Z","1.1.0":"2025-08-15T04:19:16.517Z"},"bugs":{"url":"https://github.com/boseong/mcp-servers/issues"},"author":{"name":"boseong"},"license":"MIT","homepage":"https://github.com/boseong/mcp-servers/tree/main/server/gpt5-server#readme","keywords":["mcp","model-context-protocol","gpt5","gpt-5","openai","claude","ai","openai-gpt5"],"repository":{"type":"git","url":"git+https://github.com/boseong/mcp-servers.git"},"description":"MCP server for OpenAI GPT-5 API with dual interface support (simple + messages)","maintainers":[{"name":"boseong","email":"a31829660@gmail.com"}],"readme":"# @boseong/mcp-openai-gpt5\n\nMCP (Model Context Protocol) server for OpenAI GPT-5 API integration with dual interface support. This server provides two complementary ways to interact with OpenAI's GPT-5 models through the MCP protocol.\n\n## Features\n\n- **Dual Interface Support**: Two complementary tools for different use cases\n  - `gpt5_generate`: Simple text generation with prompts\n  - `gpt5_messages`: Structured conversations with message arrays\n- **Flexible Configuration**: Support for reasoning effort levels (low, medium, high)\n- **Comprehensive Parameters**: Temperature, top-p, token limits, system instructions\n- **Detailed Usage Tracking**: Token consumption reporting for both prompt and completion\n- **Smart Environment Handling**: Multiple .env file location support for different deployment scenarios\n\n## What Makes This Different\n\nThis server differs from existing GPT-5 MCP implementations by providing:\n\n1. **Two Distinct Tools**: Unlike single-tool servers, this provides both simple and structured interfaces\n2. **Enhanced Token Reporting**: Detailed usage statistics including prompt/completion/total tokens\n3. **Flexible Environment**: Supports multiple .env file locations for various deployment setups\n4. **Message-First Design**: Built specifically for structured conversation workflows\n\n## Installation\n\n### Using NPM (Global Installation)\n\n```bash\nnpm install -g @boseong/mcp-openai-gpt5\n```\n\n### Using NPX (No Installation Required)\n\nYou can run the server directly with npx without installing:\n\n```bash\nnpx @boseong/mcp-openai-gpt5\n```\n\n## Configuration\n\n### Setting up OpenAI API Key\n\nYou need an OpenAI API key to use this server. You can set it in two ways:\n\n#### Option 1: Environment Variable\n\nSet the `OPENAI_API_KEY` environment variable:\n\n```bash\nexport OPENAI_API_KEY=your-api-key-here\n```\n\n#### Option 2: Claude Desktop Configuration\n\nAdd the API key directly in your Claude Desktop configuration file.\n\n### Claude Code Integration\n\nTo use this server with Claude Code, you can use either `gpt5` or `openai-gpt5` as the server name. Use the `mcp add` command:\n\n#### Option 1: Short Name (Recommended)\n```bash\n# Add the MCP server using the short name \"gpt5\"\nclaude mcp add gpt5 --env OPENAI_API_KEY=your-openai-api-key-here \\\n  -- npx @boseong/mcp-openai-gpt5\n```\n\n#### Option 2: Full Name (Legacy)\n```bash\n# Add the MCP server using the full name \"openai-gpt5\"\nclaude mcp add openai-gpt5 --env OPENAI_API_KEY=your-openai-api-key-here \\\n  -- npx @boseong/mcp-openai-gpt5\n```\n\nOr using the add-json command for more complex configuration:\n\n```bash\n# Using short name\nclaude mcp add-json gpt5 --scope user '{\n  \"command\": \"npx\",\n  \"args\": [\"@boseong/mcp-openai-gpt5\"],\n  \"env\": {\n    \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n  }\n}'\n\n# Using full name\nclaude mcp add-json openai-gpt5 --scope user '{\n  \"command\": \"npx\",\n  \"args\": [\"@boseong/mcp-openai-gpt5\"],\n  \"env\": {\n    \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n  }\n}'\n```\n\n### Claude Desktop Integration\n\nTo use this server with Claude Desktop, add it to your Claude Desktop configuration:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\nYou can use either `gpt5` (recommended) or `openai-gpt5` as the server key:\n\n#### Option 1: Short Name Configuration (Recommended)\n```json\n{\n  \"mcpServers\": {\n    \"gpt5\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boseong/mcp-openai-gpt5\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Option 2: Full Name Configuration (Legacy)\n```json\n{\n  \"mcpServers\": {\n    \"openai-gpt5\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boseong/mcp-openai-gpt5\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nIf you installed globally, you can also use:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5\": {\n      \"command\": \"mcp-openai-gpt5\",\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### gpt5_generate\n\nSimple text generation with a prompt.\n\n**Parameters:**\n- `input` (required): The prompt text\n- `model` (optional): Model variant (default: \"gpt-5\")\n- `instructions` (optional): System instructions for the model\n- `reasoning_effort` (optional): \"low\" | \"medium\" | \"high\"\n- `max_tokens` (optional): Maximum tokens to generate\n- `temperature` (optional): 0-2 range for randomness\n- `top_p` (optional): 0-1 range for nucleus sampling\n\n### gpt5_messages\n\nStructured conversation with message arrays.\n\n**Parameters:**\n- `messages` (required): Array of conversation messages\n  - `role`: \"user\" | \"developer\" | \"assistant\"\n  - `content`: Message content\n- Same optional parameters as `gpt5_generate`\n\n## Usage Examples\n\nOnce configured in Claude Desktop, you can use the GPT-5 tools directly in your conversations:\n\n1. **Simple generation**: Ask Claude to use GPT-5 to generate text\n2. **Conversation mode**: Use GPT-5 with structured messages for multi-turn conversations\n3. **Reasoning tasks**: Enable high reasoning effort for complex problems\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/yourusername/mcp-server-gpt5.git\ncd mcp-server-gpt5\nnpm install\nnpm run build\n```\n\n### Running Locally\n\n```bash\nnpm start\n```\n\n## Requirements\n\n- Node.js >= 18.0.0\n- OpenAI API key with GPT-5 access\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nFor issues and questions, please visit the [GitHub repository](https://github.com/yourusername/mcp-server-gpt5).","readmeFilename":"README.md"}