Mcp_mlb_statsapi
baseball-mcp: An MLB Stats API Wrapper for MCP
This project provides an MCP (Multi-Channel Pipeline) server that acts as a wrapper for the MLB Stats API. It allows you to easily access and process various MLB data points, including schedules, game results, and team information. This server is designed for efficient data retrieval and processing within an MCP framework.
Features
- Game Schedules: Retrieve MLB game schedules for specified date ranges, optionally filtering by team.
- Game Results: Fetch daily game results, including scores, winning/losing teams, and winning pitcher.
- Team Results: Get detailed results for a specific team's most recent game, including scoring plays and highlights.
- Player Lookup: Look up player IDs using last name, first name, or a combination of both. Supports fuzzy matching.
Installation
The mcp_mlb_statsapi package is available on PyPI and can be installed using pip:
pip install mcp_mlb_statsapi
or you can clone this repo, run it with soruce code.
Usage
The server exposes several tools via MCP. You can interact with them using the MCP client.
Claude for Desktop Integration
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
"mcpServers": {
"mcp_mlb_statsapi": {
"command": "{YOUR_PYTHON_EXECUTABLE_PATH}/python",
"args": ["-m",
"mcp_mlb_statsapi"]
}
}
}
If you install it via source code
{
"mcpServers": {
"mcp_mlb_statsapi": {
"command": "{YOUR_UV_EXECUTABLE_PATH}/uvx",
"args": [
"mcp_mlb_statsapi"
]
}
}
}
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Server Config
{
"mcpServers": {
"mcp_mlb_statsapi": {
"command": "{YOUR_PYTHON_EXECUTABLE_PATH}/python",
"args": [
"-m",
"mcp_mlb_statsapi"
]
}
}
}