MCP Server for Agent8
A server implementing the Model Context Protocol (MCP) to support Agent8 SDK development. Developed with TypeScript and pnpm, supporting stdio and SSE transports.
Features
This Agent8 MCP Server implements the following MCP specification capabilities:
Prompts
- System Prompt for Agent8 SDK : Provides optimized guidelines for Agent8 SDK development through the
system-prompt-for-agent8-sdk prompt template.
Tools
- Code Examples Search : Retrieves relevant Agent8 game development code examples from a vector database using the
search_code_examples tool.
Installation
# Install dependencies
pnpm install
# Build
pnpm build
Usage
Command Line Options
# View help
pnpm start --help
# View version information
pnpm start --version
Supported options:
--debug: Enable debug mode--transport <type>: Transport type (stdio or sse), default: stdio--port <number>: Port to use for SSE transport, default: 3000--log-destination <dest>: Log destination (stdout, stderr, file, none)--log-file <path>: Path to log file (when log-destination is file)--log-level <level>: Log level (debug, info, warn, error), default: info--env-file <path>: Path to .env file
Using Environment Variables
The server supports configuration via environment variables, which can be set directly or via a .env file.
- Create a
.env file in the project root (see .env.example for reference):
# Copy the example file
cp .env.example .env
# Edit the .env file with your settings
nano .env
- Run the server (it will automatically load the
.env file):
pnpm start
- Or specify a custom path to the
.env file:
pnpm start --env-file=/path/to/custom/.env
Configuration Priority
The server uses the following priority order when determining configuration values:
- Command line arguments (highest priority)
- Environment variables (from
.env file or system environment)
- Default values (lowest priority)
This allows you to set baseline configuration in your .env file while overriding specific settings via command line arguments when needed.
Supported Environment Variables
| Variable |
Description |
Default |
| MCP_TRANSPORT |
Transport type (stdio or sse) |
stdio |
| MCP_PORT |
Port to use for SSE transport |
3000 |
| LOG_LEVEL |
Log level (debug, info, warn, error) |
info |
| LOG_DESTINATION |
Log destination (stdout, stderr, file, none) |
stderr (for stdio transport), stdout (for sse transport) |
| LOG_FILE |
Path to log file (when LOG_DESTINATION is file) |
(none) |
| DEBUG |
Enable debug mode (true/false) |
false |
| SUPABASE_URL |
Supabase URL for database connection |
(required) |
| SUPABASE_SERVICE_ROLE_KEY |
Supabase service role key for authentication |
(required) |
| OPENAI_API_KEY |
OpenAI API key for AI functionality |
(required) |
Using Stdio Transport
# Build and run
pnpm build
pnpm start --transport=stdio
Using SSE Transport
# Build and run (default port: 3000)
pnpm build
pnpm start --transport=sse --port=3000
Debug Mode
# Run in debug mode
pnpm start --debug
Available Prompts
Client Integration
Using with Claude Desktop
- Add the following to Claude Desktop configuration file (
claude_desktop_config.json):
{
"mcpServers": {
"Agent8": {
"command": "npx",
"args": ["--yes", "agent8-mcp-server"]
}
}
}
- Restart Claude Desktop
Adding New Prompts
Add new prompts to the registerSamplePrompts method in the src/prompts/provider.ts file.
License
MIT
