Jarvis

🚀 Jarvis MCP 服務器

Jarvis MCP 服務器是一個基於模型上下文協議（MCP）的實現，它提供了強大的 AI 助手功能，同時集成了豐富的系統工具，為用戶與 AI 模型的交互提供了標準化的解決方案。

🚀 快速開始

Jarvis MCP 服務器通過模型上下文協議（MCP）實現與 AI 模型的無縫集成，提供了一種標準化的方式來與 AI 助手進行交互，並有效管理上下文。該服務器採用 Go 語言構建，具有高性能和高可靠性的特點。

✨ 主要特性

• MCP 協議支持：使用 mark3labs/mcp - go 完整實現模型上下文協議。
• 安全優先設計：可配置命令阻止和目錄訪問控制。
• 系統集成：在安全控制下執行終端命令。
• 文件系統操作：安全地進行文件讀取、寫入和操作。
• 文本編輯工具：基於行操作的高級文本編輯功能。
• HTTP 抓取工具：內置網頁內容抓取功能。
• 配置管理：通過 MCP 工具進行運行時配置更新。
• Go 語言實現：用 Go 編寫的高性能服務器，具備強大的錯誤處理能力。

📦 安裝指南

前提條件

• Go 1.24.4 或更高版本
• Git

安裝步驟

1. 克隆倉庫：

git clone (https://github.com/can-acar/jarvis)
cd jarvis

2. 安裝依賴：

go mod download

3. 構建項目：

go build -o jarvis main.go

💻 使用示例

啟動服務器

./jarvis

服務器將啟動，並通過標準輸入輸出使用 MCP 協議進行通信。

配置

服務器使用 config.yaml 文件進行配置：

# 安全設置
blockedCommands:
  - rm
  - shutdown
  
# 命令執行的默認 shell
defaultShell: bash

# 文件操作允許的目錄
allowedDirectories:
  - /tmp
  - /var/log

# 文件操作限制
fileReadLineLimit: 1000
fileWriteLineLimit: 50

# 遙測
telemetryEnabled: false

可用工具

服務器提供以下 MCP 工具：

配置工具

• get - config - 獲取當前服務器配置
• set - config - 更新服務器配置值

終端工具

• execute - command - 在安全控制下執行 shell 命令
• get - command - history - 獲取命令執行歷史

文件系統工具

• read - file - 支持分頁讀取文件內容
• write - file - 向文件寫入內容
• list - directory - 列出目錄內容
• create - directory - 創建新目錄
• delete - file - 刪除文件和目錄
• move - file - 移動/重命名文件和目錄
• file - info - 獲取文件元數據和信息

文本編輯工具

• edit - file - 執行復雜的文本編輯操作
• search - replace - 在文件中搜索和替換文本
• batch - edit - 對文件應用多個編輯操作

抓取工具

• fetch - url - 從網頁 URL 抓取內容
• download - file - 從遠程源下載文件

📚 詳細文檔

項目結構

jarvis/
├── main.go                    # 主服務器入口點
├── config.yaml               # 服務器配置
├── go.mod                    # Go 模塊定義
├── go.sum                    # Go 模塊校驗和
├── handlers/                 # MCP 工具處理程序
│   ├── config_handler.go     # 配置管理
│   ├── terminal_handler.go   # 終端操作
│   ├── filesystem_handler.go # 文件系統操作
│   ├── textediting_handler.go # 文本編輯工具
│   └── fetch_handler.go      # HTTP 抓取操作
└── internal/                 # 內部包
    ├── common/               # 共享實用程序
    ├── config/               # 配置管理
    ├── terminal/             # 終端實用程序
    ├── filesystem/           # 文件系統實用程序
    ├── textedit/             # 文本編輯實用程序
    ├── fetch/                # 抓取實用程序
    └── types/                # 類型定義

構建和測試

# 構建項目
go build -o jarvis main.go

# 運行測試
go test ./...

# 運行並開啟詳細日誌
go run main.go

# 為不同平臺構建
GOOS=windows GOARCH=amd64 go build -o jarvis.exe main.go
GOOS=linux GOARCH=amd64 go build -o jarvis-linux main.go

添加自定義工具

要添加新的 MCP 工具，請按以下步驟操作：

1. 在相應的處理程序文件中創建處理函數：

func HandleNewTool(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    // 實現代碼
    return mcp.NewToolResultText("Result"), nil
}

2. 在相應的內部包中註冊工具：

func RegisterNewTools(s *server.MCPServer) {
    s.AddTool("new - tool", "Description", map[string]interface{}{
        "type": "object",
        "properties": map[string]interface{}{
            "param": map[string]interface{}{
                "type": "string",
                "description": "Parameter description",
            },
        },
        "required": []string{"param"},
    }, handlers.HandleNewTool)
}

3. 在 main.go 中調用註冊函數。

貢獻代碼

1. 分叉倉庫
2. 創建功能分支：git checkout -b feature - name
3. 進行更改並添加測試
4. 確保代碼遵循 Go 規範：go fmt ./...
5. 運行測試：go test ./...
6. 提交更改：git commit -m 'Add feature'
7. 推送到分支：git push origin feature - name
8. 提交拉取請求

🔧 技術細節

• 命令安全：對命令進行清理並與阻止模式進行檢查。
• 文件系統訪問：將文件系統訪問限制在允許的目錄內。
• 命令執行：命令執行包含超時控制。
• 操作日誌：記錄所有操作以便進行審計。
• 配置限制：可通過配置限制危險操作。

📄 許可證

本項目採用 MIT 許可證，請參閱 LICENSE 文件獲取詳細信息。

支持與反饋

若您需要支持或有疑問，可以：

• 在 GitHub 上創建問題
• 查看文檔和代碼註釋
• 查看現有的問題和討論

性能說明

• 高性能：使用 Go 語言構建，具備高併發和高性能特點。
• 高效文件操作：文件操作高效，且具有可配置的限制。
• 內存優化：採用內存敏感設計，可處理大文件。
• 通信優化：針對通過標準輸入輸出的 MCP 協議通信進行了優化。