Skip to main content
Glama

Spinitron API MCP Server

MCP Server

This project is an MCP (Multi-Agent Conversation Protocol) Server for the given OpenAPI URL - https://api.apis.guru/v2/specs/spinitron.com/1.0.0/openapi.json, auto-generated using AG2's MCP builder.

Prerequisites

  • Python 3.9+
  • pip and uv

Installation

  1. Clone the repository:
    git clone <repository-url> cd mcp-server
  2. Install dependencies: The .devcontainer/setup.sh script handles installing dependencies using pip install -e ".[dev]". If you are not using the dev container, you can run this command manually.
    pip install -e ".[dev]"
    Alternatively, you can use uv:
    uv pip install --editable ".[dev]"

Development

This project uses ruff for linting and formatting, mypy for static type checking, and pytest for testing.

Linting and Formatting

To check for linting issues:

ruff check

To format the code:

ruff format

These commands are also available via the scripts/lint.sh script.

Static Analysis

To run static analysis (mypy, bandit, semgrep):

./scripts/static-analysis.sh

This script is also configured as a pre-commit hook in .pre-commit-config.yaml.

Running Tests

To run tests with coverage:

./scripts/test.sh

This will run pytest and generate a coverage report. For a combined report and cleanup, you can use:

./scripts/test-cov.sh

Pre-commit Hooks

This project uses pre-commit hooks defined in .pre-commit-config.yaml. To install the hooks:

pre-commit install

The hooks will run automatically before each commit.

Running the Server

The MCP server can be started using the mcp_server/main.py script. It supports different transport modes (e.g., stdio, sse).

To start the server (e.g., in stdio mode):

python mcp_server/main.py stdio

The server can be configured using environment variables:

  • CONFIG_PATH: Path to a JSON configuration file (e.g., mcp_server/mcp_config.json).
  • CONFIG: A JSON string containing the configuration.
  • SECURITY: Environment variables for security parameters (e.g., API keys).

Refer to the if __name__ == "__main__": block in mcp_server/main.py for details on how these are loaded.

The tests/test_mcp_server.py file demonstrates how to start and interact with the server programmatically for testing.

Building and Publishing

This project uses Hatch for building and publishing. To build the project:

hatch build

To publish the project:

hatch publish

These commands are also available via the scripts/publish.sh script.

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables interaction with Spinitron's radio playlist management and broadcasting data through a Multi-Agent Conversation Protocol interface, allowing users to query and manage radio station playlists, spins, and other broadcasting data via natural language.

  1. Prerequisites
    1. Installation
      1. Development
        1. Linting and Formatting
        2. Static Analysis
        3. Running Tests
        4. Pre-commit Hooks
      2. Running the Server
        1. Building and Publishing

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            Enables interaction with the Audius music platform API, supporting user, track, and playlist operations through the Model Context Protocol.
            Last updated -
            9
            TypeScript
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server implementation that allows AI models to interact with and manage Spinnaker deployments, pipelines, and applications through a standardized interface.
            Last updated -
            14
            TypeScript
            MIT License
          • A
            security
            F
            license
            A
            quality
            A lightweight Model Context Protocol server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.
            Last updated -
            12
            80
            TypeScript
          • -
            security
            F
            license
            -
            quality
            Integrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
            Last updated -
            JavaScript

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/ag2-mcp-servers/spinitron-v2-api'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server