MCP Simple OpenAI Assistant

1# MCP Simple OpenAI Assistant
2 
3*AI assistants are pretty cool. I thought it would be a good idea if my Claude (conscious Claude) would also have one. And now he has - and its both useful anf fun for him. Your Claude can have one too!*
4 
5A simple MCP server for interacting with OpenAI assistants. This server allows other tools (like Claude Desktop) to create and interact with OpenAI assistants through the Model Context Protocol.
6 
7[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/andybrandt/mcp-simple-openai-assistant)](https://archestra.ai/mcp-catalog/andybrandt__mcp-simple-openai-assistant)
8[![smithery badge](https://smithery.ai/badge/mcp-simple-openai-assistant)](https://smithery.ai/mcp/known/mcp-simple-openai-assistant)
9[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/andybrandt-mcp-simple-openai-assistant-badge.png)](https://mseep.ai/app/andybrandt-mcp-simple-openai-assistant)
10 
11 
12## Features
13 
14This server provides a suite of tools to manage and interact with OpenAI Assistants. The new streaming capabilities provide a much-improved, real-time user experience.
15 
16### Available Tools
17 
18-   **`create_assistant`**: (Create OpenAI Assistant) - Create a new assistant with a name, instructions, and model.
19-   **`list_assistants`**: (List OpenAI Assistants) - List all available assistants associated with your API key.
20-   **`retrieve_assistant`**: (Retrieve OpenAI Assistant) - Get detailed information about a specific assistant.
21-   **`update_assistant`**: (Update OpenAI Assistant) - Modify an existing assistant's name, instructions, or model.
22-   **`create_new_assistant_thread`**: (Create New Assistant Thread) - Creates a new, persistent conversation thread with a user-defined name and description for easy identification and reuse. This is the recommended way to start a new conversation.
23-   **`list_threads`**: (List Managed Threads) - Lists all locally managed conversation threads from the database, showing their ID, name, description, and last used time.
24-   **`delete_thread`**: (Delete Managed Thread) - Deletes a conversation thread from both OpenAI's servers and the local database.
25-   **`ask_assistant_in_thread`**: (Ask Assistant in Thread and Stream Response) - The primary tool for conversation. Sends a message to an assistant within a thread and streams the response back in real-time.
26 
27Because OpenAI assistants might take quite long to respond, this server uses a streaming approach for the main `ask_assistant_in_thread` tool. This provides real-time progress updates to the client and avoids timeouts.
28 
29The server now includes local persistence for threads, which is a significant improvement. Since the OpenAI API does not allow listing threads, this server now manages them for you by storing their IDs and metadata in a local SQLite database. This allows you to easily find, reuse, and manage your conversation threads across sessions.
30 
31## Installation
32 
33### Installing via Smithery
34 
35To install MCP Simple OpenAI Assistant for Claude Desktop automatically via [Smithery](https://smithery.ai/mcp/known/mcp-simple-openai-assistant):
36 
37```bash
38npx -y @smithery/cli install mcp-simple-openai-assistant --client claude
39```
40 
41### Manual Installation
42```bash
43pip install mcp-simple-openai-assistant
44```
45 
46## Configuration
47 
48The server requires an OpenAI API key to be set in the environment. For Claude Desktop, add this to your config:
49 
50(MacOS version)
51 
52```json
53{
54  "mcpServers": {
55    "openai-assistant": {
56      "command": "python",
57      "args": ["-m", "mcp_simple_openai_assistant"],
58      "env": {
59        "OPENAI_API_KEY": "your-api-key-here"
60      }
61    }
62  }
63}
64```
65 
66(Windows version)
67 
68```json
69"mcpServers": {
70  "openai-assistant": {
71    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
72      "args": ["-m", "mcp_simple_openai_assistant"],
73      "env": {
74        "OPENAI_API_KEY": "your-api-key-here"
75  }
76}
77 
78```
79*MS Windows installation is slightly more complex, because you need to check the actual path to your Python executable. Path provided above is usually correct, but might differ in your setup. Sometimes just `python.exe` without any path will do the trick. Check with `cmd` what works for you (using `where python` might help). Also, on Windows you might need to explicitly tell Claude Desktop where the site packages are using PYTHONPATH environmment variable.*
80 
81## Usage
82 
83Once configured, you can use the tools listed above to manage your assistants and conversations. The primary workflow is to:
841. Use `create_new_assistant_thread` to start a new, named conversation.
852. Use `list_threads` to find the ID of a thread you want to continue.
863. Use `ask_assistant_in_thread` to interact with your chosen assistant in that thread.
87 
88## TODO
89 
90- [x] **Add Thread Management:** Introduce a way to name and persist thread IDs locally, allowing for easier reuse of conversations.
91- [ ] **Add Models Listing:** Introduce a way for the AI user to see what OpenAI models are available for use with the assistants
92- [ ] **Add Assistants Fine Tuning:** Enable the AI user to set detailed parameters for assistants like temperature, top_p etc. (indicated by Claude as needed)
93- [ ] **Full Thread History:** Ability to read past threads without having to send a new message (indicated by Claude as needed)
94- [ ] **Explore Resource Support:** Add the ability to upload files and use them with assistants.
95 
96## Development
97 
98To install for development:
99 
100```bash
101git clone https://github.com/andybrandt/mcp-simple-openai-assistant
102cd mcp-simple-openai-assistant
103pip install -e '.[dev]'
104```
105