Brightsy MCP Server

Brightsy MCP Server

This is a Model Context Protocol (MCP) server that connects to an Brightsy AI agent.

Installation

Usage

To start the server:

Or with positional arguments:

You can also provide an initial message to be sent to the agent:

Customizing the Tool Name

By default, the MCP server registers a tool named "brightsy". You can customize this name using the --tool-name parameter:

You can also set the tool name as the third positional argument:

Or using the BRIGHTSY_TOOL_NAME environment variable:

Environment Variables

The following environment variables can be used to configure the server:

• BRIGHTSY_AGENT_ID: The agent ID to use (alternative to command line argument)
• BRIGHTSY_API_KEY: The API key to use (alternative to command line argument)
• BRIGHTSY_TOOL_NAME: The tool name to register (default: "brightsy")

Testing the agent_proxy Tool

The agent_proxy tool allows you to proxy requests to an Brightsy AI agent. To test this tool, you can use the provided test scripts.

Prerequisites

Before running the tests, set the following environment variables:

Alternatively, you can pass these values as command-line arguments:

Running the Tests

To run all tests:

To run specific tests:

Test Scripts

1. Command Line Test (test-agent-proxy.ts): Tests the agent_proxy tool by running the MCP server with a test message.
2. Direct MCP Protocol Test (test-direct.ts): Tests the agent_proxy tool by sending a properly formatted MCP request directly to the server.

How the Tool Works

The MCP server registers a tool (named "brightsy" by default) that forwards requests to an OpenAI-compatible AI agent and returns the response. It takes a messages parameter, which is an array of message objects with role and content properties.

Example usage in an MCP client:

The response will contain the agent's reply in the content field.