Ariunbolor Nsaf MCP Server

🚀 NSAF MCP Server

This is a Model Context Protocol (MCP) server designed for the Neural Symbolic Autonomous Framework (NSAF). It allows AI assistants to interact with the NSAF framework via the MCP protocol.

⚠️ Important Note

This repository contains both the NSAF framework code and the MCP server implementation, making it a complete package that can be deployed and used anywhere.

⚠️ Important Note

This implementation uses a simplified version of the MCP protocol and does not require the official MCP SDK. It implements the core functionality needed to expose NSAF features.

✨ Features

• Run NSAF evolution with customizable parameters.
• Compare different NSAF agent architectures.
• Integrate NSAF functionality into AI assistants.

📦 Prerequisites

• Node.js 18+ and npm
• Python 3.8+ with the NSAF framework installed

📦 Installation

1. Clone this repository:

git clone https://github.com/ariunbolor/nsaf-mcp-server.git
cd nsaf-mcp-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

📚 Configuration

The server includes the NSAF framework code, so no additional configuration is required for basic use. The MCP server is designed to be ready to use out of the box.

💻 Usage Examples

Run the server locally

npm start

Deploy to GitHub

1. Create a new GitHub repository for your MCP server:

   • Go to GitHub and create a new repository named nsaf-mcp-server.
   • Initialize it with a README file.

2. Push the code to GitHub using the provided setup script:

# For a new repository
./setup-github-fixed.sh yourusername

# If the repository already exists and you want to overwrite the contents
./setup-github-fixed.sh yourusername --force

This script will perform the following actions:

• Initialize git if necessary.
• Set up the remote repository.
• Commit changes.
• Attempt to push to GitHub (with options to handle existing repositories).

3. Configure GitHub Actions for CI/CD (optional):
   • Create the .github/workflows directory.
   • Add workflow files for testing and building the server.

Use with an AI assistant

To use this MCP server with an AI assistant (such as Claude), you need to do the following:

1. Install the server:

   Option 1: Install from GitHub (after pushing the code):

npm install -g yourusername/nsaf-mcp-server

Option 2: Install from a local directory:

# Navigate to the nsaf_mcp_server directory
cd nsaf_mcp_server

# Install dependencies and build
npm install
npm run build

# Install globally from the local directory
npm install -g .

2. Add the server to your MCP settings configuration:

For the Claude desktop application, edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "nsaf": {
      "command": "nsaf-mcp-server",
      "args": [],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Cline, edit /Users/onthego/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "nsaf": {
      "command": "nsaf-mcp-server",
      "args": [],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

run_nsaf_evolution

Run NSAF evolution with customizable parameters.

compare_architectures

Compare the performance and characteristics of different NSAF agent architectures.

📄 License