Eyevinn Open Source Cloud

Model Context Protocol (MCP) server for using the Eyevinn Open Source Cloud API

typescript

7

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "eyevinnosc-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@osaas/mcp-server"
      ],
      "env": {
        "OSC_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

You deploy and run a local MCP server that provides MCP tooling for Eyevinn Open Source Cloud, enabling you to manage MinIO storage buckets and objects from your own computer. This server is designed to work with an MCP client to perform file operations against OSC storage without needing to run everything remotely.

How to use

You use this MCP server with an MCP client to perform storage-related actions on OSC from your local machine. Practical workflows include creating a MinIO bucket in OSC, uploading a file to a bucket, and listing files already stored in a bucket. Use the local MCP server when you need direct access to OSC resources from your workstation or desktop MCP client.

How to install

Prerequisites: you need Node.js and npm installed on your computer.

Install the MCP server client automatically via Smithery from your terminal.

npx -y @smithery/cli install @osaas/mcp-server --client claude

Configuration for Claude Desktop

Configure Claude Desktop to connect to both a local and a remote MCP server. You will manage OSC access with a Personal Access Token.

{
  "mcpServers": {
    "local-mcp-osc": {
      "command": "npx",
      "args": ["-y", "@osaas/mcp-server"],
      "env": {
        "OSC_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    },
    "remote-mcp-osc": {
      "command": "npx",
      "args": ["-y", "@osaas/client-mcp"],
      "env": {
        "OSC_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Personal Access Token

If you do not already have an Eyevinn OSC account, sign up for one. In the Eyevinn OSC web console, open Settings > API settings and copy your Personal Access Token.

Development

If you want to run a development tool to inspect or debug the MCP server, use the inspector with your OSC access token.

npx @modelcontextprotocol/inspector \
  -e OSC_ACCESS_TOKEN=<osc-access-token> \
  npx tsx src/index.ts

Notes on usage

The MCP server is intended to be used as a local component that works with an MCP client to perform storage operations in OSC from your workstation. Keep your access token secure and only expose the MCP client in trusted environments.

Available tools

create_bucket

Create a MinIO storage bucket in OSC to store objects.

upload_file

Upload a file to a MinIO storage bucket in OSC.

list_files

List files stored in a MinIO storage bucket in OSC.