billster45 mcp chatgpt responses

billster45 mcp chatgpt responses avatar

by billster45

MCP server for access to OpenAI's ChatGPT API with Responses API for conversation management

What is billster45 mcp chatgpt responses

*MseeP.ai Security Assessment Badge*

MCP ChatGPT Server

*smithery badge*

This MCP server allows you to access OpenAI's ChatGPT API directly from Claude Desktop.

📝 Read about why I built this project: I Built an AI That Talks to Other AIs: Demystifying the MCP Hype

Features

  • Call the ChatGPT API with customisable parameters
  • Aks Claude and ChatGPT to talk to each other in a long running discussion!
  • Configure model versions, temperature, and other parameters
  • Use web search to get up-to-date information from the internet
  • Uses OpenAI's Responses API for automatic conversation state management
  • Use your own OpenAI API key

Setup Instructions

Installing via Smithery

To install ChatGPT Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @billster45/mcp-chatgpt-responses --client claude

Prerequisites

  • Python 3.10 or higher
  • Claude Desktop application
  • OpenAI API key
  • uv for Python package management

Installation

  1. Clone this repository:

    git clone https://github.com/billster45/mcp-chatgpt-responses.git
    cd mcp-chatgpt-responses
    
  2. Set up a virtual environment and install dependencies using uv:

    uv venv
    
    .venv\\Scripts\\activate
    
    uv pip install -r requirements.txt
    

Using with Claude Desktop

  1. Configure Claude Desktop to use this MCP server by following the instructions at: MCP Quickstart Guide-mcp-server)

  2. Add the following configuration to your Claude Desktop config file (adjust paths as needed):

    {
      "mcpServers": {
        "chatgpt": {
          "command": "uv",
          "args": [
            "--directory",
            "\\path\\to\\mcp-chatgpt-responses",
            "run",
            "chatgpt_server.py"
          ],
          "env": {
            "OPENAI_API_KEY": "your-api-key-here",
            "DEFAULT_MODEL": "gpt-4o",
            "DEFAULT_TEMPERATURE": "0.7",
            "MAX_TOKENS": "1000"
          }
        }
      }
    }
    
  3. Restart Claude Desktop.

  4. You can now use the ChatGPT API through Claude by asking questions that mention ChatGPT or that Claude might not be able to answer.

Available Tools

The MCP server provides the following tools:

  1. ask_chatgpt(prompt, model, temperature, max_output_tokens, response_id) - Send a prompt to ChatGPT and get a response

  2. ask_chatgpt_with_web_search(prompt, model, temperature, max_output_tokens, response_id) - Send a prompt to ChatGPT with web search enabled to get up-to-date information

Example Usage

Basic ChatGPT usage:

Tell Claude to ask ChatGPT a question!

Use the ask_chatgpt tool to answer: What is the best way to learn Python?

Tell Claude to have a conversation with ChatGPT:

Use the ask_chatgpt tool to have a two way conversation between you and ChatGPT about the topic that is most important to you.

Note how in a turn taking conversation the response id allows ChatGPT to store the history of the conversation so its a genuine conversation and not just as series of API calls. This is called conversation state.

With web search:

For questions that may benefit from up-to-date information:

Use the ask_chatgpt_with_web_search tool to answer: What are the latest developments in quantum computing?

Now try web search in agentic way to plan your perfect day out based on the weather!

Use the ask_chatgpt_with_web_search tool to find the weather tomorrow in New York, then based on that weather and what it returns, keep using the tool to build up a great day out for someone who loves food and parks

How It Works

This tool utilizes OpenAI's Responses API, which automatically maintains conversation state on OpenAI's servers. This approach:

  1. Simplifies code by letting OpenAI handle the conversation history
  2. Provides more reliable context tracking
  3. Improves the user experience by maintaining context across messages
  4. Allows access to the latest information from the web with the web search tool

License

MIT License

Leave a Comment

Frequently Asked Questions

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications, providing a standardized way to connect AI models to different data sources and tools.

What are MCP Servers?

MCP Servers are lightweight programs that expose specific capabilities through the standardized Model Context Protocol. They act as bridges between LLMs like Claude and various data sources or services, allowing secure access to files, databases, APIs, and other resources.

How do MCP Servers work?

MCP Servers follow a client-server architecture where a host application (like Claude Desktop) connects to multiple servers. Each server provides specific functionality through standardized endpoints and protocols, enabling Claude to access data and perform actions through the standardized protocol.

Are MCP Servers secure?

Yes, MCP Servers are designed with security in mind. They run locally with explicit configuration and permissions, require user approval for actions, and include built-in security features to prevent unauthorized access and ensure data privacy.

Submit Your MCP Server

Share your MCP server with the community

Submit Now