mcp-client -host-demo

This MCP server (host-demo) provides Pokémon data and attack actions that can be discovered and invoked by an MCP client and an HTTP server used by LLMs. The server exposes a data model for Pokémon entries and a set of attack capabilities that can be invoked as MCP tools. You can run the accompanying client, which in turn starts the MCP server, and you can also access an HTTP interface to list available tools and trigger attacks via an LLM-friendly endpoint.

To interact with the server, first start the client/server combo using the provided script. The MCP client will spin up the MCP server in-process and register its capabilities so that tool catalogs (like /tools) and specific actions (like /attack) can be discovered and executed by clients and the HTTP gateway. When using the HTTP server, you can query the tools endpoint to see which Pokémon data queries and attack actions are available, and you can trigger a random Pokémon attack using the attack tool through the LLM integration.

Prerequisites:

• A JavaScript runtime such as Bun installed on your system. If you don’t have Bun installed, visit https://bun.sh and install Bun.
• Access to a shell or terminal.

Installation steps:

1. Install project dependencies using Bun:

bun install

2. Run the MCP server and client demo (this starts the MCP server via the client script):

bun mcp_client.ts

3. Run the HTTP server for LLM integration (after setting your API key):

export OPENROUTER_API_KEY=your_api_key_here
bun http_server.ts

4. Open your browser to http://localhost:3005 to access:

• /tools to list available tools
• /attack to execute a random Pokémon attack using the LLM

Note: This project uses Bun as the runtime.

Tips and common considerations:

• Ensure Bun is installed and available in your PATH before running the commands.
• The HTTP server requires an OpenRouter API key; set OPENROUTER_API_KEY in your environment before starting the server.
• If you encounter port conflicts, you can modify the http_server.ts to listen on a different port.
• The host-demo MCP server exposes Pokémon data and attack actions; extend or customize the data model by editing the underlying source files if needed for your demo.