#MCP 服务器集成

Model Context Protocol (MCP) 让你的 AI 助手能够调用外部工具——查数据库、搜网络、操作文件。本文介绍如何在 Aino LifeOS 中配置和使用 MCP。

#第一步：了解配置层级

Aino LifeOS 支持三级 MCP 配置，优先级从高到低：

#第二步：添加你的第一个 MCP 服务器

#方式一：在 Vault 中配置（推荐新手）

在你的 Vault 根目录创建 .mcp.json 文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

保存后重启 Aino LifeOS，服务器会自动加载。

#方式二：用户级配置

如果你希望所有 Vault 都能用某个工具，编辑 ~/.claude/mcp.json：

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-web-search"]
    }
  }
}

#方式三：应用级配置

编辑 <userData>/mcp.json（适合团队统一配置）：

{
  "mcpServers": {
    "company-tools": {
      "command": "node",
      "args": ["./tools/mcp-server.js"]
    }
  }
}

#第三步：确认服务器运行状态

配置完成后，打开 Aino LifeOS：

1. 服务器会在启动时自动发现并加载
2. 查看 MCP 管理面板，确认状态为「运行中」
3. 点击服务器名称，可以看到它提供的工具列表

如果服务器异常退出，Aino LifeOS 会自动重启。

#第四步：在 AI 聊天中使用 MCP 工具

MCP 服务器加载成功后，AI 聊天会自动获得这些工具能力：

1. 打开 AI 智能聊天
2. 正常提问，AI 会根据需要自动调用 MCP 工具
3. 例如配置了 web-search 后，你可以问：「帮我搜索最新的 React 19 变更」

AI 会调用搜索工具、获取结果、整理后回复你。

#传输协议

#Stdio（推荐）

子进程方式运行，适合本地工具：

• 启动快、延迟低
• 无需网络配置
• 进程随 Aino LifeOS 自动管理

#HTTP

连接远程 MCP 服务器，适合团队共享：

• 支持 CORS
• 可通过中间件自定义

#内置 MCP HTTP 服务器

Aino LifeOS 自带一个 MCP HTTP 服务器（默认端口 1478），允许外部工具反向接入。用途：

• 浏览器扩展通过 HTTP 连接 Aino LifeOS
• 其他应用集成你的笔记数据
• 自定义自动化流程

#常见配置示例

#文件系统访问

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}

#网络搜索

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-web-search"]
    }
  }
}

#相关操作

• AI 智能聊天 — MCP 工具在聊天中被 AI 自动调用
• AI 代码代理 — 代码代理可使用 MCP 工具完成复杂任务