Nsaf MCP Server

🚀 NSAF MCP 服務器

NSAF MCP 服務器是為神經符號自主框架 (NSAF) 實現的模型上下文協議 (MCP) 服務器，它讓 AI 助手能夠通過 MCP 協議與 NSAF 框架進行交互，為 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 許可證。