Nife.io MCP Server

A Model Context Protocol (MCP) server that interfaces with the Nife.io GraphQL API

Installation • Quick Start • Documentation • Contributing

---

Overview

The Nife.io MCP Server provides a standardized interface for interacting with the Nife.io GraphQL API through the Model Context Protocol. It enables seamless usage within Claude Desktop and other MCP-compatible clients, ensuring a consistent, secure, and efficient integration experience.

Key Features

• Intelligent GraphQL schema discovery and adaptation
• Dynamic MCP tool generation based on schema
• Minimal configuration and fast setup
• Secure authentication using bearer tokens
• Installable via PyPI, NPM, or directly from source
• Compatible with macOS, Linux, and Windows
• Production-grade error handling and logging

Installation

Option 1: PyPI (Recommended for Python environments)

pip install nife-mcp-server

Option 2: NPM (Recommended for Claude Desktop usage)

npx @nifelabs/mcp-server

Option 3: Install from Source

git clone https://github.com/nife-io/nife-mcp-server.git
cd nife-mcp-server
pip install -r requirements.txt

Quick Start

1. Obtain Your Access Token

nifectl auth login
nifectl auth token

2. Configure Claude Desktop

{
  "mcpServers": {
    "nife": {
      "command": "npx",
      "args": ["-y", "@nife/mcp-server"],
      "env": {
        "NIFE_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

3. Restart Claude Desktop

Your Nife.io MCP integration will now be active.

Usage

Starting the Server

# Installed via pip
nife-mcp-server

# Running from source
python -m nife_mcp_server.intelligent_main

The server will start on:
http://0.0.0.0:5000

Environment Variables

• NIFE_ACCESS_TOKEN – Required authentication token
• NIFE_API_ENDPOINT – Optional custom GraphQL endpoint

Example Prompts for Claude

List all my applications in Nife.io  
Show the status of my deployments  
Create a new application named "my-app"

Architecture

┌─────────────────┐
│  Claude Desktop │
└────────┬────────┘
         │ MCP Protocol
┌────────▼────────┐
│  Nife MCP Server│
└────────┬────────┘
         │ GraphQL
┌────────▼────────┐
│   Nife.io API   │
└─────────────────┘

Core Components

• Schema Manager
• MCP Tool Generator
• Query Builder
• Authentication Layer

API Endpoints

MCP Endpoints

Endpoint	Method	Description
/api/mcp/context	GET	Retrieve model context
/api/mcp/context	POST	Update model context
/api/mcp/schema	GET	Retrieve GraphQL schema
/api/mcp/query	POST	Execute custom query
/api/mcp/health	GET	Health check

GraphQL Capabilities

• Query all supported resource types
• Execute mutations for resource management
• Run custom queries
• Perform schema introspection

Development

Local Development Setup

git clone https://github.com/nife-io/nife-mcp-server.git
cd nife-mcp-server

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

pip install -r requirements.txt
pip install -e .
python -m nife_mcp_server.intelligent_main

Project Structure

nife-mcp-server/
├── src/
│   └── nife_mcp_server/
│       ├── intelligent_main.py
│       ├── schema_manager.py
│       └── routes/
│           └── mcp.py
├── tests/
├── docs/
└── bin/

Running Tests

pytest
pytest --cov=nife_mcp_server

Support

• GitHub Issues: https://github.com/nife-io/nife-mcp-server/issues
• GitHub Discussions: https://github.com/nife-io/nife-mcp-server/discussions

---

Made by the Nife.io team

Website • Documentation • Blog