viso
MCP server from visotrust/viso-mcp-server
claude mcp add --transport stdio visotrust-viso-mcp-server docker run -i --rm -e VISOTRUST_API_TOKEN -e VISOTRUST_API_BASEURL visotrustai/viso-mcp-server:latest \
--env VISOTRUST_API_TOKEN="${input:viso_token}" \
--env VISOTRUST_API_BASEURL="${input:viso_baseurl}"How to use
The VISO TRUST MCP Server provides a bridge between the VISO TRUST API and AI assistants via the MCP (Model Context Protocol). It enables clients to query the VISO TRUST capabilities from within an MCP workflow, passing through tokens and a base API URL to authenticate and access VISO TRUST resources. The server supports multiple deployment profiles; by default it runs locally and communicates via standard I/O, while the remote profile enables Server-Sent Events (SSE) for remote clients and distributed deployments. To use it with a container, you typically set the VISOTRUST_API_TOKEN and VISOTRUST_API_BASEURL environment variables, then run the container so the MCP clients can reach the API and exchange messages over HTTP/SSE or standard I/O depending on the chosen profile. You can also run the server directly with Java or within a Docker container depending on your environment. In MCP client configurations, you will specify the server under mcpServers with the appropriate command and environment variables, for example using Docker as shown in the setup examples.
How to install
Prerequisites:
- Java 21+ (if you plan to run the server directly via JAR/Gradle)
- Gradle (for building from source)
- Docker (optional, for containerized deployment)
Installation steps (Docker):
- Ensure you have Docker installed and running.
- Pull or run the VISO MCP Server Docker image with required environment variables: docker run -i --rm -e VISOTRUST_API_TOKEN=<your-api-token> -e VISOTRUST_API_BASEURL=https://app.visotrust.com visotrustai/viso-mcp-server:latest
Installation steps (from source, Java):
- Ensure Java 21+ and Gradle are installed.
- Clone the repository and navigate to the project directory.
- Build the project: ./gradlew build
- Run the server (examples; choose profile as needed): java -jar viso-mcp-server-<version>.jar --port 8080 --host localhost or ./gradlew bootRun --args="--spring.profiles.active=remote"
Installation steps (VS Code integration):
- Use the provided install buttons or add the docker-based configuration shown in the README to your MCP settings in VS Code. The configuration will use the visotrustai/viso-mcp-server:latest image with environment variables VISOTRUST_API_TOKEN and VISOTRUST_API_BASEURL.
Additional notes
Environment variables:
- VISOTRUST_API_TOKEN: Your VISO TRUST API token (required).
- VISOTRUST_API_BASEURL: Base URL for the VISO TRUST API (default: https://app.visotrust.com). Profile tips:
- Default profile (no explicit profile) uses standard I/O for local development.
- remote profile enables SSE-based remote communication; use --spring.profiles.active=remote when running the Java/jar version, or set SPRING_PROFILES_ACTIVE=remote for Docker runs. Common issues:
- Ensure the API token has the necessary permissions in VISO TRUST.
- If using Docker, ensure network access to the VISOTRUST API base URL and that the token is passed via environment variables.
- When running in remote mode, verify SSE endpoints are accessible by clients and that logging is enabled for distributed debugging.
