The Brightsy MCP Server acts as a bridge to an OpenAI-compatible AI agent, allowing you to:
- Proxy Requests: Forward requests from an MCP client to a Brightsy AI agent using a customizable tool name (default is "brightsy").
- Handle Structured Input: Process standard chat format inputs with
messages
arrays containingrole
andcontent
properties. - Configure Flexibly: Set up the server using either command-line arguments or environment variables.
- Connect Securely: Use configurable credentials (agent ID and API key) to authenticate with the Brightsy AI agent.
- Test Functionality: Utilize included scripts for both command-line and direct MCP protocol testing.
Allows forwarding requests to an Brightsy AI agent using an OpenAI-compatible format, enabling interaction with the agent through a standardized messages array with role and content properties.
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
- Command Line Test (
test-agent-proxy.ts
): Tests the agent_proxy tool by running the MCP server with a test message. - 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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A server that implements the Model Context Protocol to connect LLMs to Brightsy AI agents, allowing users to pass messages to and receive responses from these agents.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides LLM Agents with a comprehensive toolset for IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.Last updated -1656610TypeScriptApache 2.0
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.Last updated -1828TypeScript
- -securityAlicense-qualityModel Context Protocol server implementation that integrates the LINE Messaging API to connect AI agents with LINE Official Accounts, enabling agents to send messages to users.Last updated -158TypeScriptApache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that provides AI assistants with access to Glean's enterprise knowledge features, including content search, people directory, and AI chat capabilities.Last updated -3345TypeScriptMIT License