nebulablock-mcp-server

This repository hosts the official NebulaBlock API Model Context Protocol (MCP) server. This server integrates with the fastmcp library to expose the full range of NebulaBlock API functionalities as accessible tools, enabling seamless and efficient interaction within any MCP-compatible environment.

.
├── src/
│   ├── __init__.py
│   ├── config.py
│   ├── main.py
│   ├── tools.py
│   └── mcp_project.egg-info/
├── tests/
│   ├── __init__.py
│   └── test_main.py
├── scripts/
├── docs/
├── .env.example
├── .gitignore
├── pyproject.toml
├── README.md
└── uv.lock

• src/: Contains the main application source code, including configuration and tool definitions.
• tests/: Contains unit and integration tests.
• scripts/: Reserved for utility scripts (e.g., setup, data generation).
• docs/: Reserved for supplementary documentation.
• .env.example: Example file for environment variables.
• .gitignore: Specifies intentionally untracked files to ignore.
• pyproject.toml: Project metadata and build system configuration, including dependencies and project information.
• README.md: This documentation file.
• uv.lock: Lock file for uv dependency management.

To set up and run this project, follow these steps:

1. Clone the repository (if applicable):

    git clone https://github.com/Nebula-Block-Data/api-mcp
    cd mcp-project

1. Create a virtual environment:

It's highly recommended to use a virtual environment to manage project dependencies.

    python3 -m venv .venv

1. Activate the virtual environment:

• macOS/Linux:

source .venv/bin/activate

1. Install dependencies:

This project uses pyproject.toml for dependency management. Install setuptools and then the project in editable mode.

    uv pip install -e .

This will install fastmcp and any ot