JarvisJr MCP 服务器使用说明

项目简介

JarvisJr MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为 LLM 客户端（如 Claude Desktop）提供扩展功能。它通过集成各种工具，例如日历管理、任务管理、网页搜索和笔记存储，使 LLM 能够执行更复杂的任务并访问外部信息。

主要功能点

工具扩展: 集成日历管理、任务管理、笔记存储和网页搜索等多种实用工具。
本地和 Webhook 工具: 支持本地工具和通过 Webhook 集成的外部服务工具，方便灵活地扩展功能。
灵活配置: 通过 'tools.json' 文件轻松配置和扩展工具，支持环境变量，方便集成外部服务。
标准 MCP 协议: 遵循 MCP 协议，可以与任何兼容 MCP 协议的 LLM 客户端无缝对接，例如 Claude Desktop。

安装步骤

安装 Node.js: 确保你的电脑上已安装 Node.js 运行环境 (https://nodejs.org/)。
安装 Claude Desktop App: 如果你计划与 Claude Desktop 集成，请先安装 Claude Desktop 应用程序 (https://claude.ai/desktop)。
下载项目: 从 GitHub 仓库下载 JarvisJrMCP 项目代码。你可以使用 Git 克隆仓库，或者直接下载 ZIP 文件并解压到本地。
- 使用 Git 克隆:
```
git clone https://github.com/Sjotie/JarvisJrMCP.git
cd JarvisJrMCP
```
- 下载 ZIP 文件:
  - 访问仓库 https://github.com/Sjotie/JarvisJrMCP
  - 点击绿色 "Code" 按钮
  - 选择 "Download ZIP"
  - 解压 ZIP 文件，并在终端/命令提示符中导航到解压后的文件夹
安装依赖: 在项目根目录下打开终端或命令提示符，运行以下命令安装项目所需的依赖包：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 JarvisJr MCP Server 与 MCP 客户端（例如 Claude Desktop）连接，你需要配置客户端以指向你的服务器。对于 Claude Desktop，你需要编辑其配置文件 'claude_desktop_config.json'。

找到配置文件: 打开 Claude Desktop 配置文件 'claude_desktop_config.json'。该文件通常位于：
- Windows: '%APPDATA%/Claude/claude_desktop_config.json' （在文件资源管理器地址栏输入 '%APPDATA%/Claude' 并回车即可访问）
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json' （在 Finder 中使用快捷键 'Command + Shift + G'，输入 '~/Library/Application Support/Claude' 并回车即可访问）

编辑配置文件: 在 'claude_desktop_config.json' 文件中，找到 'mcpServers' 字段（如果没有则手动创建），并添加以下配置信息：

{
  "mcpServers": {
    "jarvisjr": {
      "command": "node",
      "args": [
        "/path/to/your/JarvisJrMCP/build/index.js"  // 将 "/path/to/your/JarvisJrMCP" 替换为你的 JarvisJrMCP 项目的实际路径
      ],
      "env": {
        "WEBHOOK_URL": "your-webhook-url-here" // 可选：如果需要使用 Webhook 工具，请在此处设置 Webhook 服务的基础 URL
      }
    }
  }
}

配置参数说明:

'server name': 服务器名称，这里设置为 "jarvisjr"，你可以自定义名称。
'command': 启动服务器的命令，这里使用 'node'，确保你的系统环境变量中 'node' 命令可用。
'args': 启动命令的参数，指向构建后的 'index.js' 文件路径。请务必将 '/path/to/your/JarvisJrMCP' 替换为你 JarvisJrMCP 项目在你的电脑上的实际绝对路径。 例如，如果你的项目放在 'C:\Users\YourName\Documents\JarvisJrMCP'，那么 'args' 应该配置为 '["C:\Users\YourName\Documents\JarvisJrMCP\build\index.js"]' (注意 Windows 路径中的反斜杠需要转义)。
'env': 环境变量，'WEBHOOK_URL' 用于配置 Webhook 工具的基础 URL。如果你配置的工具有 Webhook 服务，请在此处设置你的 Webhook 服务地址。如果不需要 Webhook 工具，可以忽略 'env' 字段。

基本使用方法

启动服务器: 配置 Claude Desktop 后，当你启动 Claude Desktop 应用程序时，JarvisJr MCP Server 将会自动启动。你无需手动运行服务器。
在 Claude 中使用工具: 在 Claude Desktop 中，你可以通过自然语言指示 Claude 使用 JarvisJr 服务器提供的工具。例如：
- 你可以要求 Claude "创建一个新的日历事件" 来测试日历管理工具。
- 你可以让 Claude "搜索今天的头条新闻" 来使用网页搜索功能。
- 你可以指示 Claude "记录一个笔记" 来测试笔记存储功能。
工具调用: Claude 会根据你的指示，通过 MCP 协议向 JarvisJr 服务器发送请求。服务器会调用相应的工具，并将结果返回给 Claude，从而实现扩展的功能。

请注意，具体的功能和使用方式取决于 JarvisJr MCP Server 实现的工具和 Prompt 模板。你可以参考仓库中的 'README.md' 和 'src/config/tools.json' 文件了解更多关于可用工具的信息。

关键词