{"id":26613541,"url":"https://github.com/techspawn/mcp-turboclient","last_synced_at":"2025-03-24T04:34:50.532Z","repository":{"id":283036226,"uuid":"950440333","full_name":"techspawn/MCP-TurboClient","owner":"techspawn","description":"A FastAPI-based application that provides a web interface for interacting with Multiple Control Protocol (MCP) servers while utilizing OpenAI's API for processing messages.","archived":false,"fork":false,"pushed_at":"2025-03-18T08:04:30.000Z","size":95,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T09:23:36.835Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/techspawn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-18T06:56:51.000Z","updated_at":"2025-03-18T08:04:34.000Z","dependencies_parsed_at":"2025-03-18T09:23:42.514Z","dependency_job_id":null,"html_url":"https://github.com/techspawn/MCP-TurboClient","commit_stats":null,"previous_names":["techspawn/mcp-turboclient"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techspawn%2FMCP-TurboClient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techspawn%2FMCP-TurboClient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techspawn%2FMCP-TurboClient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techspawn%2FMCP-TurboClient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techspawn","download_url":"https://codeload.github.com/techspawn/MCP-TurboClient/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245211925,"owners_count":20578437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-24T04:34:49.818Z","updated_at":"2025-03-24T04:34:50.518Z","avatar_url":"https://github.com/techspawn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP TurboClient [🚀](http://127.0.0.1:8080/#)\n\nA FastAPI-based application that provides a web interface for interacting with Multiple Control Protocol (MCP) servers while utilizing OpenAI's API for processing messages.\n\n## Overview\n\nThis application allows users to:\n\n- Connect to multiple MCP servers simultaneously\n- Process messages through OpenAI's API\n- Interact with the system via a web-based chat interface\n- Configure and store API license keys\n\n## Tech Stack\n\n**Client:** html, css, js, bootstrap, animatedjs\n\n**Server:** FastAPI, Openai, MCP\n\n## Features\n\n- Connect multiple servers at a time\n- Use websocket any where you want\n\n## Screenshots\n\n![App Screenshot](images/chat_window.png \"Chat window image\")\n\n![App Screenshot](images/setting_page.png \"Setting page image\")\n\n## Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/techspawn/MCP-TurboClient.git\n   cd openai-mcp\n   ```\n2. Install dependencies:\n\n   ```bash\n   uv pip install -r requirements.txt\n   ```\n3. Set up your environment variables:\n\n   ```bash\n   export MODEL_NAME=\"gpt-4-turbo\" # or your preferred OpenAI model\n   ```\n\n## Environment Variables\n\nTo run this project, you will need to add the following environment variables to your .env file\n\n`MODEL_NAME=gpt-3.5-turbo`\n\n## Configuration\n\n1. Create a `config.json` file in the root directory:\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"server1\": {\n         \"command\": \"your_command\",\n         \"args\": [\"arg1\", \"arg2\"]\n       },\n       \"server2\": {\n         \"command\": \"another_command\",\n         \"args\": [\"arg1\", \"arg2\"]\n       }\n     }\n   }\n   ```\n2. Initialize the SQLite database:\n\n   ```python\n   import sqlite3\n\n   conn = sqlite3.connect(\"mcp_config.db\")\n   cursor = conn.cursor()\n   cursor.execute(\"CREATE TABLE IF NOT EXISTS config (license_key TEXT)\")\n   conn.commit()\n   conn.close()\n   ```\n3. Configure your OpenAI API key through the web interface.\n\n## Usage\n\n1. Start the application:\n\n   ```bash\n   uvicorn main:app --reload\n   ```\n2. Open your browser and navigate to `http://localhost:8000`\n3. Enter your OpenAI API key in the web interface to save it to the database\n4. Use the chat interface to send messages that will be processed through the MCP servers and OpenAI\n\n## Usage\n\n1. Start the application:\n\n   ```bash\n   uvicorn main:app --reload\n   ```\n2. Open your browser and navigate to `http://localhost:8000`\n3. Enter your OpenAI API key in the web interface to save it to the database\n4. Use the chat interface to send messages that will be processed through the MCP servers and OpenAI\n\n## Project Structure\n\n```\n├── images/                    # Directory for storing image assets\n│   ├── chat_window.png        # Screenshot of the chat window\n│   └── setting_page.png       # Screenshot of the settings page\n├── models/                    # Contains Python modules related to data models\n│   ├── __init__.py            # Makes the 'models' directory a Python package\n│   ├── client.py              # Defines client-related logic (e.g., API client, user handling)\n│   ├── config.py              # Handles application configuration settings\n│   └── py.typed               # Indicates that this package supports type hints\n├── static/                    # Placeholder for static assets (CSS, JavaScript, images)\n├── templates/                 # Directory for HTML templates\n│   ├── base.html              # Base template for consistent layout across pages\n│   ├── chat.html              # Template for the chat interface\n│   └── settings.html          # Template for the settings page\n├── .env                       # Environment variables (e.g., API keys, credentials)\n├── .gitignore                 # Specifies files to be ignored by Git\n├── .python-version            # Defines the Python version for this project\n├── config.json                # JSON configuration file for application settings\n├── database.py                # Handles database connection and operations\n├── folder_structure.txt        # Text file describing the project structure\n├── LICENSE                    # License file specifying usage terms\n├── main.py                     # Entry point of the application\n├── mcp_config.db               # SQLite database file or config storage\n├── pyproject.toml              # Python project metadata and dependency management\n├── README.md                   # Project documentation and setup instructions\n├── requirements.txt            # List of required dependencies\n└── uv.lock                     # Lock file for package versions (possibly from `uv` or another package manager)\n\n```\n\n## API Endpoints\n\n- `GET /`: Main chat interface\n- `POST /get_settings`: Save OpenAI API license key\n- `WebSocket /chat`: Real-time chat communication\n\n## Contributing\n\nContributions are always welcome!\n\nSee `contributing.md` for ways to get started.\n\n## Support\n\nFor support, email [support@techspawn.com](support@techspawn.com)\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechspawn%2Fmcp-turboclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechspawn%2Fmcp-turboclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechspawn%2Fmcp-turboclient/lists"}