https://github.com/fbettag/openai-deep-research-mcp
OpenAI Deep Research MCP Server
https://github.com/fbettag/openai-deep-research-mcp
Last synced: 2 months ago
JSON representation
OpenAI Deep Research MCP Server
- Host: GitHub
- URL: https://github.com/fbettag/openai-deep-research-mcp
- Owner: fbettag
- Created: 2025-07-09T12:03:58.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-09T17:14:58.000Z (4 months ago)
- Last Synced: 2025-08-18T03:39:24.032Z (3 months ago)
- Language: JavaScript
- Size: 54.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **openai-deep-research-mcp** - OpenAI Deep Research MCP Server `javascript` `chatgpt` `deep-research` `deep-research-agent` `mcp` `npm install fbettag/openai-deep-research-mcp` (🤖 AI/ML)
- awesome-mcp-servers - **openai-deep-research-mcp** - OpenAI Deep Research MCP Server `javascript` `chatgpt` `deep-research` `deep-research-agent` `mcp` `npm install fbettag/openai-deep-research-mcp` (AI/ML)
README
# OpenAI Deep Research MCP Server
A TypeScript MCP (Model Context Protocol) server that provides access to OpenAI's Deep Research API.
## Features
- **openai_deep_research_create**: Create new research requests
- **openai_deep_research_check_status**: Check the status of research requests
- **openai_deep_research_get_results**: Retrieve completed research results with citations
## Quick Start
```bash
npx github:fbettag/openai-deep-research-mcp
```
## Quick Setup with Claude CLI
```bash
claude mcp add openai-deep-research -s user npx github:fbettag/openai-deep-research-mcp -e OPENAI_API_KEY=sk-your-openai-api-key-here
```
Replace `sk-your-openai-api-key-here` with your actual OpenAI API key.
## Claude Desktop Setup (Manual)
Add to your Claude Desktop configuration:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"openai-deep-research": {
"command": "npx",
"args": ["github:fbettag/openai-deep-research-mcp"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-api-key-here"
}
}
}
}
```
## Available Functions
### Create Research Request
```typescript
openai_deep_research_create({
query: "Your research question",
system_message?: "Optional guidance",
model?: "o3-deep-research-2025-06-26",
include_code_interpreter?: false
})
```
### Check Status
```typescript
openai_deep_research_check_status({
request_id: "req_123..."
})
```
### Get Results
```typescript
openai_deep_research_get_results({
request_id: "req_123..."
})
```
## Models
- `o3-deep-research-2025-06-26`: Full research model (5-30 min)
- `o4-mini-deep-research-2025-06-26`: Faster, lightweight model
## Requirements
- Node.js >= 18.0.0
- OpenAI API key with Deep Research access
## Development
```bash
npm install
npm run dev
```
## License
MIT