MMCPMarkets
NP

naveenbandarage/poke-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

17 stars 11 forks Качество 66 Тренд 21MIT
Repository Install

A repo to play around with MCP (Model Context Protocol) and to query the PokeDex API

Обзор

Poke-MCP is a Model Context Protocol (MCP) server that provides Pokémon information through a standardized interface. It connects to the PokeAPI to fetch Pokémon data and exposes it through MCP tools that can be used by any MCP-compatible client, such as Claude Desktop App, Continue, Cline, and others. - Get information about specific Pokémon by name - Discover random Pokémon - Find random Pokémon from specific regions (Kanto, Johto, Hoenn, etc.) - Get random Pokémon of specific types (Fire, Water, Electric, etc.) - Natural language query interface for Pokémon information Poke-MCP is built using the Model Context Protocol, which enables AI applications to access external tools and data sources in a standardized way. The server: 1. Connects to the PokeAPI to fetch Pokémon data 2. Exposes several tools through the MCP interface 3. Processes requests from MCP clients 4.

README

Показан фрагмент оригинального README. Открыть оригинал.

Overview

Poke-MCP is a Model Context Protocol (MCP) server that provides Pokémon information through a standardized interface. It connects to the PokeAPI to fetch Pokémon data and exposes it through MCP tools that can be used by any MCP-compatible client, such as Claude Desktop App, Continue, Cline, and others.

This server now supports HTTP transport using Server-Sent Events (SSE) for real-time communication, making it accessible over HTTP instead of just stdio.

Features

  • Get information about specific Pokémon by name
  • Discover random Pokémon
  • Find random Pokémon from specific regions (Kanto, Johto, Hoenn, etc.)
  • Get random Pokémon of specific types (Fire, Water, Electric, etc.)
  • Natural language query interface for Pokémon information

How It Works

Poke-MCP is built using the Model Context Protocol, which enables AI applications to access external tools and data sources in a standardized way. The server:

  1. Connects to the PokeAPI to fetch Pokémon data
  2. Exposes several tools through the MCP interface
  3. Processes requests from MCP clients
  4. Returns formatted Pokémon information

MCP Tools

The server provides the following tools:

  • get-pokemon: Get detailed information about a specific Pokémon by name
  • random-pokemon: Get information about a random Pokémon
  • random-pokemon-from-region: Get a random Pokémon from a specific region
  • random-pokemon-by-type: Get a random Pokémon of a specific type
  • pokemon-query: Answer natural language queries about Pokémon

Architecture

The server is built using:

  • TypeScript
  • MCP TypeScript SDK (@modelcontextprotocol/sdk)
  • Zod for input validation
  • HTTP transport with Server-Sent Events (SSE) for MCP communication
  • Node.js built-in HTTP server

Installation

Installing via Smithery

To install Pokémcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# Install dependencies
npm install

# Build the project
npm run build

Usage

Running the HTTP Server

To start the server in HTTP mode:

# Start the server (defaults to port 3000)
npm start

# Or specify a custom port
PORT=8080 npm start

The server will be available at:

Открыть полный README на GitHub

Установка

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "pokedex": { "transport": { "type": "sse", "url": "http://127.0.0.1:3000/sse" } } } }