nife-mcp-server 1.0.2

Model Context Protocol server for Nife.io GraphQL API

Nife.io MCP Server

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

Installation • Quick Start • Documentation • Contributing

---

🌟 Overview

Nife MCP Server provides a standardized interface to interact with Nife.io's GraphQL API through the Model Context Protocol, enabling seamless integration with Claude Desktop and other MCP-compatible applications.

✨ Key Features

• 🧠 Intelligent Schema Discovery - Automatically discovers and adapts to the GraphQL schema
• 🔧 Dynamic Tool Generation - Creates MCP tools on-the-fly from schema
• 🚀 Zero Configuration - Works out of the box with minimal setup
• 🔒 Secure Authentication - Bearer token support with flexible configuration
• 📦 Multiple Install Methods - PyPI, NPM, or GitHub
• 🌐 Cross-Platform - Works on macOS, Linux, and Windows
• ⚡ Production Ready - Comprehensive error handling and logging

📦 Installation

Option 1: PyPI (Recommended for Python users)

pip install nife-mcp-server

Option 2: NPM (Best for Claude Desktop)

npx @nife/mcp-server

Option 3: 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. Get Your Access Token

nifectl auth login
nifectl auth token

2. Configure Claude Desktop

Add to your Claude Desktop configuration:

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

3. Restart Claude Desktop

Your Nife.io integration is now active! 🎉

📚 Documentation

• Quick Start Guide - Get started in 5 minutes
• API Documentation - Complete API reference
• Release Guide - For contributors and maintainers
• Contributing - How to contribute

🎯 Usage

Starting the Server

# If installed via pip
nife-mcp-server

# If 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 - Your Nife.io access token
• NIFE_API_ENDPOINT - Custom GraphQL endpoint (optional)

Example Usage with Claude

Once configured, you can ask Claude:

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

🏗️ Architecture

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

Core Components

• Schema Manager - Intelligent GraphQL schema introspection
• Tool Generator - Dynamic MCP tool creation
• Query Builder - Smart query construction
• Authentication - Secure token management

🔌 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	Get GraphQL schema
/api/mcp/query	POST	Execute custom queries
/api/mcp/health	GET	Health check

GraphQL Integration

The server provides full access to Nife.io's GraphQL API:

• ✅ Query all resources (apps, deployments, etc.)
• ✅ Execute mutations (create, update, delete)
• ✅ Custom query execution
• ✅ Schema introspection

🛠️ Development

Setup Development Environment

# Clone the repository
git clone https://github.com/nife-io/nife-mcp-server.git
cd nife-mcp-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt
pip install -e .  # Install in editable mode

# Run the server
python -m nife_mcp_server.intelligent_main

Project Structure

nife-mcp-server/
├── src/
│   └── nife_mcp_server/
│       ├── intelligent_main.py  # Main server logic
│       ├── schema_manager.py    # GraphQL schema handling
│       └── routes/
│           └── mcp.py          # MCP route handlers
├── tests/                      # Test suite
├── docs/                       # Documentation
└── bin/                        # Executable scripts

Running Tests

pytest
pytest --cov=nife_mcp_server  # With coverage

🤝 Contributing

We love contributions! Please see our Contributing Guide for details.

Ways to Contribute

• 🐛 Report bugs
• 💡 Suggest features
• 📝 Improve documentation
• 💻 Submit pull requests

Development Process

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📊 Stats

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built for the Model Context Protocol
• Powered by Nife.io
• Designed for Claude Desktop

📞 Support

• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📖 Documentation: Full Docs

🗺️ Roadmap

• WebSocket support for real-time updates
• GraphQL subscriptions
• Enhanced caching layer
• Query batching
• Metrics and monitoring
• Docker Compose examples
• Kubernetes manifests

⭐ Star History

If you find this project useful, please consider giving it a star!

---

Made with ❤️ by the Nife.io team

Website • Documentation • Blog