code-portal-mcp

CodePortal MCP Server

This server helps you organize code files into properly structured projects and provides direct access to AI models like OpenAI and Google.

Features

• Project Organization - Structure projects using your existing Script_starter.py
• Security First - All settings are local and secure
• API Key Management - Store your OpenAI and Google keys securely
• Direct AI Access - Generate text from OpenAI or Google directly on your computer
• Auto-shutdown - Server closes after 15 minutes to keep your system clean

Getting Started

1. Clone this repository to your computer

   git clone https://github.com/TylerALofall/code-portal-mcp.git
   cd code-portal-mcp
   

2. Double-click start_server.bat to start the server

3. Open your browser to http://localhost:8001/setup

   • Complete the initial setup
   • Configure your Script_starter.py paths

Using the AI Features

1. Visit http://localhost:8001/ai/ui after starting the server
2. Add your API keys in the "API Keys" tab:
   • OpenAI key (starts with sk-)
   • Google Generative AI key (starts with AIza)
3. Use the "Generate Text" tab to:
   • Choose your provider (OpenAI or Google)
   • Enter your prompt
   • Get AI responses directly on your computer

Project Management

The server can create properly organized projects from multiple files:

import requests

# Files to organize
files = {
    "main.py": "# Your Python code here",
    "utils.py": "# Utility functions",
    "README.md": "# Project Documentation"
}

# Send to CodePortal
response = requests.post(
    "http://localhost:8001/createProject",
    json={
        "project_path": "C:/Users/tyler/Projects/my_project",
        "project_name": "My Project",
        "files": files
    }
)

print(response.json())

Security

• All API keys are stored locally on your computer
• The server only runs when you start it
• Auto-shutdown after 15 minutes
• Access restricted to localhost by default

For Advanced Users

You can enable external access by:

1. Going to http://localhost:8001/setup
2. Enabling "Public API Mode"
3. Setting a secure API key

This allows you to send files from other computers or AI services.

Using with Other AI Models

See for instructions on using with Claude or other external models.