{"_id":"@boseong/mcp-server-gpt5","_rev":"2-49ffdc16ff5596cea01cdf24705a4e09","name":"@boseong/mcp-server-gpt5","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@boseong/mcp-server-gpt5","version":"1.0.0","keywords":["mcp","model-context-protocol","gpt5","openai","claude","ai"],"author":{"name":"boseong"},"license":"MIT","_id":"@boseong/mcp-server-gpt5@1.0.0","maintainers":[{"name":"boseong","email":"a31829660@gmail.com"}],"homepage":"https://github.com/boseong/mcp-server-gpt5#readme","bugs":{"url":"https://github.com/boseong/mcp-server-gpt5/issues"},"bin":{"mcp-server-gpt5":"dist/index.js"},"dist":{"shasum":"b380a27302563dc62bc391eb5ba029579e55aebf","tarball":"https://registry.npmjs.org/@boseong/mcp-server-gpt5/-/mcp-server-gpt5-1.0.0.tgz","fileCount":5,"integrity":"sha512-byCgszxbLJ7E2WH9MBvr5gI448Z3SEwkwy3IOO8ephRpp1DgR8I0JRpmN0HiTf9D0ROjvI3xNdbVbFlCyV+5Qw==","signatures":[{"sig":"MEQCIDxyF+26jNWnF5SuKl8Q6QR/LLtwbIvN27dQRNHJwOBVAiAJqW+VHCXTqno/O/fjsWAm6/SeJ23XhTuGCTj9iJCGsQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16654},"main":"dist/index.js","engines":{"node":">=18.0.0"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"boseong","email":"a31829660@gmail.com"},"repository":{"url":"git+https://github.com/boseong/mcp-server-gpt5.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP server for OpenAI GPT-5 API integration","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-server-gpt5_1.0.0_1755065622611_0.6606322722331182","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@boseong/mcp-server-gpt5","version":"1.0.1","description":"MCP server for OpenAI GPT-5 API integration","type":"module","main":"dist/index.js","bin":{"mcp-server-gpt5":"dist/index.js"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node dist/index.js","build":"tsc","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","openai","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/boseong/mcp-server-gpt5.git"},"homepage":"https://github.com/boseong/mcp-server-gpt5#readme","bugs":{"url":"https://github.com/boseong/mcp-server-gpt5/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-server-gpt5@1.0.1","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-2AoPe8cvqM4ReXjYwvSzR4KvCHkoF8KxSW6DGrqDia3bCWIner/kV4WjxGMGzlRtSZwjurpRDtRl0T46uOpjZw==","shasum":"d65710d2516338e97233d1d58ac9f3e35daf7014","tarball":"https://registry.npmjs.org/@boseong/mcp-server-gpt5/-/mcp-server-gpt5-1.0.1.tgz","fileCount":5,"unpackedSize":17713,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCgUvZLl9HGbNsxs5IVU5uL7pJlQWXiBsgPwcu/tw6uPAIhAJ1KjUE79oDsF7wABI4Aczy4Je0o/UuX4RwQji1AM6hj"}]},"_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-server-gpt5_1.0.1_1755066902765_0.9979647037096262"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-13T06:13:42.532Z","modified":"2025-08-13T06:35:03.127Z","1.0.0":"2025-08-13T06:13:42.808Z","1.0.1":"2025-08-13T06:35:02.943Z"},"bugs":{"url":"https://github.com/boseong/mcp-server-gpt5/issues"},"author":{"name":"boseong"},"license":"MIT","homepage":"https://github.com/boseong/mcp-server-gpt5#readme","keywords":["mcp","model-context-protocol","gpt5","openai","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/boseong/mcp-server-gpt5.git"},"description":"MCP server for OpenAI GPT-5 API integration","maintainers":[{"name":"boseong","email":"a31829660@gmail.com"}],"readme":"# @boseong/mcp-server-gpt5\n\nMCP (Model Context Protocol) server for OpenAI GPT-5 API integration. This server allows Claude Desktop to interact with OpenAI's GPT-5 models through the MCP protocol.\n\n## Features\n\n- Simple text generation with GPT-5\n- Structured conversation with message arrays\n- Support for reasoning effort levels (low, medium, high)\n- Configurable temperature and token limits\n- Token usage tracking\n\n## Installation\n\n### Using NPM (Global Installation)\n\n```bash\nnpm install -g @boseong/mcp-server-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-server-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, use the `mcp add` command:\n\n```bash\n# Add the MCP server with environment variable\nclaude mcp add gpt5 --env OPENAI_API_KEY=your-openai-api-key-here \\\n  -- npx @boseong/mcp-server-gpt5\n```\n\nOr using the add-json command for more complex configuration:\n\n```bash\nclaude mcp add-json gpt5 --scope user '{\n  \"command\": \"npx\",\n  \"args\": [\"@boseong/mcp-server-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\nAdd the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5\": {\n      \"command\": \"npx\",\n      \"args\": [\"@boseong/mcp-server-gpt5\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"your-openai-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nOr if you installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt5\": {\n      \"command\": \"mcp-server-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"}