MCP -for-MAS-Developments

This MCP server suite provides three specialized gateways to access the PGPT API in different environments. The API-Server-with-TCP-Support acts as a legacy-friendly gateway, exposing TCP-based access for applications that rely on socket communication. The MCP-Server-with-STDIO-Support enables ultra-fast, local integration via standard input/output, ideal for direct workspace integrations with tools like Claude Desktop, VS Code, or IDE plugins. The MCP-Server-with-Streamable-HTTP-Support uses Server-Sent Events (SSE) over HTTP to support remote and web-based dashboards, with built-in Stream-Fix and Auto-Session-Recovery for unstable networks. Each server provides access to the full PGPT API surface (Chat, RAG sources, scenarios, and user management) and is configurable via pgpt.env.json. To start using a particular server, run its entrypoint (server.js) in the corresponding directory, ensuring you have a valid PGPT API key and a configured pgpt.env.json in place. TLS and RSA-based key management are supported for secure communications, and the STDIO server can operate without opening network ports for added local security.

Prerequisites:

• Node.js 20+ and npm/yarn installed
• Git installed
• Access to a PGPT Instance (version 1.5 for STDIO and SSE servers)

Installation steps:

1. Clone the repository git clone https://github.com/Fujitsu-AI/MCP-Server-for-MAS-Developments.git cd MCP-Server-for-MAS-Developments

2. Install dependencies for all server variants (example via npm in each directory) cd API-Server-with-TCP-Support npm install cd ../MCP-Server-with-STDIO-Support npm install cd ../MCP-Server-with-Streamable-HTTP-Support npm install

3. Prepare configuration

   • Create pgpt.env.json in the directory of the server you plan to run, containing your PGPT credentials and any required options.
   • Ensure TLS and key files are in place if you plan to enable TLS.

4. Run a server

   • For the TCP API gateway: node API-Server-with-TCP-Support/server.js
   • For the STDIO local integration gateway: node MCP-Server-with-STDIO-Support/server.js
   • For the SSE web gateway: node MCP-Server-with-Streamable-HTTP-Support/server.js

Optional: If a setup script is provided, you can use it to install and configure the server ./Install-MPC-Server.sh

Environment and configuration tips:

• Keep pgpt.env.json updated to reflect your PGPT credentials and API endpoints.
• For STDIO and SSE servers, a running PGPT Instance Version 1.5 is required for full API compatibility.
• TLS can be enabled to protect data in transit; configure TLS certificates and set TLS_ENABLED to true.
• RSA-based password encryption is supported for secure authentication; ensure you have id_rsa_public.pem and id_rsa keys configured.
• If you encounter network instability, prefer the STDIO server for local workflows or the SSE server with Stream-Fix and Auto-Session-Recovery features for remote usage.
• When using the TCP gateway, verify firewall rules allow the desired port ranges and consider TLS termination at a reverse proxy if exposed publicly.