Skip to main content

Xenfra MCP Server (The Bridge) 🧠

PyPI License: MIT

A Model Context Protocol (MCP) server that empowers AI agents (Claude Desktop, Cursor, Windsurf) to securely deploy, monitor, and debug infrastructure on Xenfra.

Philosophy: Tools as Skills. We expose atomic, reliable infrastructure capabilities that LLMs can orchestrate.

🤖 Available Tools

Tool Description
xenfra_deploy Deploys the project in the current working directory.
xenfra_get_logs Fetches filtered, colorized logs for a deployment.
xenfra_get_status Retrieves real-time health metrics (CPU, RAM, Uptime).
xenfra_security_scan Scans codebase for 15+ types of secrets before deployment.
xenfra_list_projects Lists all active deployments and their IDs.
xenfra_context Dumps environment summary for "Why is it broken?" queries.

📦 Installation & Configuration

For Claude Desktop

  1. Make sure you have uv installed.

  2. Edit your config file:

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Add Xenfra:

{
  "mcpServers": {
    "xenfra": {
      "command": "uvx",
      "args": ["xenfra-mcp-server"]
    }
  }
}
  1. Restart Claude Desktop. Look for the 🔌 icon.

For Custom Agents

You can run the server directly via stdio:

uvx xenfra-mcp-server

🛠️ Usage Example

User: "Deploy this app and check if it's healthy."

Agent (Using Xenfra MCP):

  1. Calls xenfra_security_scan -> "No secrets found."
  2. Calls xenfra_deploy -> "Deployment started, ID: dep_123."
  3. Calls xenfra_get_status -> "Status: 🟢 Running."

🔗 The Xenfra Ecosystem

This MCP Server is the "Brain Connector" of the Xenfra Open Core architecture:

  • xenfra-sdk: The Core Engine (Used by this Server).
  • xenfra-cli: The Terminal Interface.
  • xenfra-platform: The Private SaaS Backend.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

📄 License

MIT © Xenfra Cloud

Metadata

Release files for xenfra-mcp-server 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xenfra-mcp-server 0.1.3
File Size Uploaded
xenfra_mcp_server-0.1.3.tar.gz 13.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xenfra-mcp-server 0.1.3
File Interpreter ABI Platform
xenfra_mcp_server-0.1.3-py3-none-any.whl Python 3 none any Details

Total release size: 28.9 kB

Release files / xenfra_mcp_server-0.1.3.tar.gz

Download URL xenfra_mcp_server-0.1.3.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
5df6aa7a42d9dbda4d75852d299e9c9ca927418ca82dd6bf00a24319ae9e057f
BLAKE2b-256 checksum
How to use checksums
ead9ee2fad81e22c0d3271a18b9529ad87efc3d0b27ef7eb74f7875097b4c490
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / xenfra_mcp_server-0.1.3-py3-none-any.whl

Download URL xenfra_mcp_server-0.1.3-py3-none-any.whl
Size 15.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ced80618e9ab3e0a595240d253d51eaf925d59cdf90eb582788a0c45116ecf2e
BLAKE2b-256 checksum
How to use checksums
37b300bc57572ad2e97903365b4e2cc20ba8f29d5f837b4c5a2e05e451dfa69a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page