Port MCP Server 2wj

🚀 Port MCP Server

This is a Model Context Protocol (MCP) server for the Port.io API, enabling Claude to interact with the developer platform features of Port.io.

🚀 Quick Start

The Port MCP Server allows Claude to interact with Port.io's developer platform. Follow the installation steps below to get started.

✨ Features

Port MCP Server Capabilities

• Model Management: Supports loading and managing multiple language models.
• Inference Interface: Provides a unified inference interface to simplify the invocation process.
• Result Processing: Automatically parses inference results and offers output in multiple formats.

Interface Definitions

Load a Model

# Load the default model
curl -X POST http://localhost:8000/load-model?model_name=default

# Load a custom model
curl -X POST http://localhost:8000/load-model?model_name=my_custom_model

Perform Inference

# Single-sentence inference
curl -X POST http://localhost:8000/predict \
  -H "Content-Type: application/json" \
  -d '{"input": "Your input content"}'

# Batch inference
curl -X POST http://localhost:8000/batch-predict \
  -H "Content-Type: application/json" \
  -d '{"inputs": ["Input 1", "Input 2"]}'

Retrieve Results

# Get a single result
curl http://localhost:8000/results/123

# Get batch results
curl http://localhost:8000/batch-results?ids=123,456

📦 Installation

Obtain Your Port Credentials

1. Create a Port.io account:
   • Visit Port.io.
   • Register a new account if you don't have one.
2. Create an API key:
   • Navigate to your Port.io dashboard.
   • Go to Settings > Credentials.
   • Save the Client ID and Client Secret.

Configure Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "portMCP": {
      "type": "custom",
      "endpoint": "http://localhost:8000"
    }
  }
}

Configure in Cursor

Add the following to your settings.json or .env file:

# settings.json
{
  "mcpServers": {
    "portMCP": {
      "type": "custom",
      "endpoint": "http://localhost:8000"
    }
  }
}

# .env file
MCP_SERVERS_PORT_MCP_TYPE=custom
MCP_SERVERS_PORT_MCP_ENDPOINT=http://localhost:8000

🔧 Technical Details

Local Development

# Install dependencies
pip install -r requirements.txt

# Start the server
python -m src.port_mcp_server

Release a New Version

# Update the version number
make release VERSION=1.0.0

# Manual steps (if required)
git tag v1.0.0
git push --tags

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms of the MIT License. For more details, please refer to the LICENSE file in the project repository.