OpenAI Assistant MCP Server

# MCP Server for OpenAI This project provides a server compliant with the Machine-to-Machine Communications Protocol (MCP) that acts as a bridge to various OpenAI API functionalities. It allows MCP clients to interact with OpenAI's Chat Completion and Assistants APIs through a standardized set of tools. ## Features The server exposes several tools to interact with the OpenAI API: * **Chat Completion:** Ask a direct question to a specified model (`gpt-4`, `gpt-3.5-turbo`). * **Assistant Management:** Create, list, retrieve, update, and delete assistants. * **File Management:** Upload, list, and delete files associated with assistants. * **Tool Management:** Enable or disable tools for assistants, such as `file_search`. ## Installation To install the necessary dependencies, navigate to the project root and run: ```bash pip install . ``` This will install all the packages defined in `pyproject.toml`, including `mcp`, `openai`, and `click`. ## Usage To start the server, you need to provide your OpenAI API key. You can do this by setting an environment variable or by passing it as a command-line argument. **Using an environment variable:** ```bash export OPENAI_API_KEY='your-api-key-here' mcp-server-openai ``` **Using a command-line argument:** ```bash mcp-server-openai --openai-api-key 'your-api-key-here' ``` The server will start and listen for MCP messages over stdio. **Usage in Cursor** To configure this server in an MCP client like Cursor, use the following configuration. Replace `"LOCAL PATH"` with the absolute path to this project's directory and `"OPENAI API KEY"` with your actual key. ```json { "mcpServers": { "openai-server": { "command": "mcp-server-openai", "args": [], "env": { "PYTHONPATH": "LOCAL PATH", "OPENAI_API_KEY": "OPENAI API KEY" } } } } ``` ## Available Tools Here is a detailed list of the tools exposed by the server: | Tool | Description | Parameters | | ---------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ask-openai` | Ask a direct question. | `query` (string), `model` (enum: `gpt-4.1`, `gpt-4.1-mini`, `gpt-4o`, etc.), `temperature` (number), `max_tokens` (integer) | | `list-assistants` | List all available assistants. | None | | `retrieve-assistant` | Retrieve an assistant by its ID. | `assistant_id` (string) | | `create-assistant` | Create a new assistant. | `name` (string), `instructions` (string), `model` (string), `temperature` (number), `file_ids` (array of strings), `enable_file_search` (boolean) | | `update-assistant` | Update an existing assistant. | `assistant_id` (string), `name` (string, optional), `instructions` (string, optional), `model` (string, optional), `temperature` (number, optional), `file_ids` (array of strings, optional), `enable_file_search` (boolean, optional) | | `delete-assistant` | Delete an assistant by its ID. | `assistant_id` (string) | | `upload-file` | Upload a file for use with assistants. | `file_path` (string) | | `list-files` | List all files available for assistants. | None | | `delete-file` | Delete a file by its ID. | `file_id` (string) | ## Model Pricing Below is an estimated pricing table for some of the models available through this server. Prices are per 1 million tokens. Please verify the latest prices on the [official OpenAI pricing page](https://openai.com/pricing/), as they can change. | Model | Input Price / 1M tokens | Output Price / 1M tokens | | ----------------- | ----------------------- | ------------------------ | | `gpt-4o` | $5.00 | $15.00 | | `gpt-4o-mini` | $0.15 | $0.60 | | `gpt-4-turbo` | $10.00 | $30.00 | | `gpt-3.5-turbo` | $0.50 | $1.50 | ## Development To contribute to this project, clone the repository and install it in editable mode: ```bash git clone https://github.com/snilld-ai/openai-assistant-mcp cd openai-assistant-mcp pip install -e . ``` ## Testing The project includes a basic test file to verify the connection to the OpenAI API. To run the tests, use `pytest`: ```bash pytest ``` Make sure you have your `OPENAI_API_KEY` environment variable set. ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.