NSAF MCP 服务器

这是一个用于神经符号自主框架 (NSAF) 的模型上下文协议 (MCP) 服务器。它允许 AI 助手通过 MCP 协议与 NSAF 框架进行交互。

注意： 此存储库包含 NSAF 框架代码和 MCP 服务器实现，使其成为一个完整的软件包，可以部署并在任何地方使用。

注意： 此实现使用简化版本的 MCP 协议，不需要官方 MCP SDK。它实现了将 NSAF 功能暴露给 AI 助手所需的核心功能。

功能

• 使用可自定义的参数运行 NSAF 进化
• 比较不同的 NSAF 代理架构
• 将 NSAF 功能集成到 AI 助手中

前提条件

• Node.js 18+ 和 npm
• Python 3.8+，并安装了 NSAF 框架

安装

1. 克隆此存储库：

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

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

配置

服务器包含 NSAF 框架代码，因此基本使用不需要额外的配置。 MCP 服务器设计为全局安装后即可直接使用。

用法

在本地运行服务器

npm start

部署到 GitHub

1. 为您的 MCP 服务器创建一个新的 GitHub 存储库：

   • 转到 GitHub 并创建一个名为 nsaf-mcp-server 的新存储库
   • 使用 README 文件初始化它

2. 使用提供的设置脚本将您的代码推送到 GitHub：

# 对于新的存储库
./setup-github-fixed.sh yourusername

# 如果存储库已存在并且您想覆盖其内容
./setup-github-fixed.sh yourusername --force

该脚本将：

• 如果需要，初始化 git
• 设置远程存储库
• 提交您的更改
• 尝试推送到 GitHub（带有处理现有存储库的选项）

3. 配置 GitHub Actions 以进行 CI/CD（可选）：
   • 创建一个 .github/workflows 目录
   • 添加一个工作流程文件，用于测试和构建服务器

与 AI 助手一起使用

要将此 MCP 服务器与 Claude 等 AI 助手一起使用，您需要：

1. 安装服务器：

   选项 1：从 GitHub 安装（在推送您的代码后）：

   npm install -g yourusername/nsaf-mcp-server
   

   选项 2：从您的本地目录安装：

   # 导航到 nsaf-mcp-server 目录
   cd nsaf_mcp_server
   
   # 安装依赖项并构建
   npm install
   npm run build
   
   # 从本地目录全局安装
   npm install -g .
   

2. 将服务器添加到您的 MCP 设置配置：

对于 Claude Desktop 应用程序，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（在 macOS 上）：

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

对于 Cline，编辑 /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": []
    }
  }
}

可用工具

run_nsaf_evolution

使用指定的参数运行 NSAF 进化。

参数：

• population_size: 代理种群的大小（默认值：20）
• generations: 进化的代数（默认值：10）
• mutation_rate: 突变率 (0.0-1.0)（默认值：0.2）
• crossover_rate: 交叉率 (0.0-1.0)（默认值：0.7）
• architecture_complexity: 代理架构的复杂性（'simple'、'medium'、'complex'）（默认值：'medium'）

compare_nsaf_agents

比较不同的 NSAF 代理架构。

参数：

• architectures: 要比较的架构列表（默认值：['simple', 'medium', 'complex']）

许可证

MIT