traderfit-bridge 0.1.0

A stdio bridge for the TraderFit MCP API

TraderFit Bridge (StdIO)

This package provides a Machine Cognition Protocol (MCP) bridge using standard input/output (stdio) to connect an MCP client (like Cursor) to the TraderFitAI backend API.

Features

• Dynamically fetches available tools from the TraderFitAI OpenAPI schema.
• Executes tool calls by forwarding requests to the TraderFitAI API.
• Authenticates with the backend using an API key provided via environment variable.

Installation

# Coming soon to PyPI!
# pip install traderfit-bridge 

(Currently, installation requires cloning the repository and setting up the environment manually - see Development Setup below)

Configuration (Command-Based - Current Method)

To use this bridge with Cursor, you need to configure it in your ~/.cursor/mcp.json file within the "mcpServers" section.

Important: You must replace the placeholder paths with the absolute paths on your local machine.

1. Generate an API key from the TraderFitAI platform dashboard.
2. Clone this repository: git clone https://github.com/rizkisyaf/traderfit-bridge.git
3. Navigate into the directory: cd traderfit-bridge
4. Create and activate a Python virtual environment:

   python3 -m venv venv
   source venv/bin/activate 
   

5. Install dependencies: pip install -e . (Installs in editable mode)
6. Find the absolute path to the installed traderfit-bridge executable (usually within venv/bin/) and the project's root directory (pwd).
7. Add the following configuration to your ~/.cursor/mcp.json, replacing placeholders:

{
    "mcpServers": {
        "traderfit": {
            "name": "TraderFit",
            "description": "TraderFitAI Bridge (StdIO)",
            "protocol": "stdio",
            "command": "/absolute/path/to/your/traderfit-bridge/venv/bin/traderfit-bridge",
            "cwd": "/absolute/path/to/your/traderfit-bridge", 
            "env": {
                "TRADERFIT_API_KEY": "YOUR_TRADERFIT_API_KEY_HERE",
                "TRADERFIT_MCP_URL": "https://traderfit-mcp.skolp.com" 
            }
        }
        // ... other servers ...
    }
}

8. Reload MCP Clients in Cursor.

Configuration (Package-Based - Future)

(Details on configuring via a package manager and handling API keys via a config file will be added once implemented.)

Development Setup

1. Clone the repository:

   git clone https://github.com/rizkisyaf/traderfit-bridge.git
   cd traderfit-bridge
   

2. Create a Python virtual environment:

   python3 -m venv venv
   source venv/bin/activate 
   

3. Install dependencies, including development tools:

   pip install -e ".[dev]" 
   

   (Note: Requires defining [project.optional-dependencies] in pyproject.toml if you have dev tools like pytest, ruff, etc.)

4. Create a .env file in the project root with your API key for local testing:

   TRADERFIT_API_KEY=YOUR_TRADERFIT_API_KEY_HERE
   TRADERFIT_MCP_URL=https://traderfit-mcp.skolp.com 
   # Optional: Set LOG_LEVEL=DEBUG for more verbose logging
   # LOG_LEVEL=DEBUG 
   

5. Run the bridge directly (for testing purposes):

   python -m traderfit_bridge.main 
   

License

This project is licensed under the MIT License - see the LICENSE file for details (if one exists).