Nsaf MCP Server

🚀 NSAF MCP 服务器

NSAF MCP 服务器是专为神经符号自主框架 (NSAF) 实现的模型上下文协议 (MCP) 服务器。它借助 MCP 协议，实现了 AI 助手与 NSAF 框架的交互，为两者的协作提供了有力支持。

⚠️ 重要提示

此仓库包含 NSAF 框架代码和 MCP 服务器实现，是一个完整的包，可在任何地方部署和使用。

⚠️ 重要提示

此实现使用了简化版的 MCP 协议，无需官方 MCP SDK，却实现了与 NSAF 功能集成所需的最核心功能。

✨ 主要特性

• 🧬 使用可自定义参数运行 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. 创建一个新的 GitHub 仓库用于您的 MCP 服务器：
   • 访问 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 服务器与 AI 助手（如Claude）一起使用，需执行以下步骤：

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 应用（macOS 上）： 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件：

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

对于其他平台，请参考相关文档。

功能

运行 NSAF 进化 (run_nsaf_evolution)

node run-nsaf-evolution.js --population-size=100 --generations=50 --mutation-rate=0.1

参数：

• --population-size：种群大小（默认值：100）。
• --generations：进化代数（默认值：50）。
• --mutation-rate：变异率（默认值：0.1）。

比较 NSAF 代理架构 (compare_nsaf_agents)

node compare-nsaf-agents.js --agent1=agent1.json --agent2=agent2.json

参数：

• --agent1：第一个代理文件路径。
• --agent2：第二个代理文件路径。

📄 许可证

此项目采用 MIT 许可证。