🔌

MCP工具

本地AI助手

Q: lingxi 如何安装和开始使用？

访问 lingxi 的 GitHub 仓库或官方网站，按照 README 文档中的步骤安装依赖并运行。通常需要 Python 3.8+ 或 Node.js 16+ 基础环境。

Q: lingxi 是否免费？许可证是什么？

lingxi 完全免费，采用 NOASSERTION 许可证开源发布，任何人都可以免费使用、修改和分发。

Q: lingxi 适合哪些用户使用？

lingxi 主要面向有一定技术基础的用户，包括开发者、数据分析师、AI 工程师等专业人士。

Q: lingxi 的社区活跃度和项目维护状况如何？

lingxi 在 GitHub 上已获得 6 个 Star，处于积极发展阶段，社区在持续扩大。

基于 JavaScript · 让 AI 助手直接操作你的系统与工具

英文名：lingxi

⭐ 6 Stars 🍴 1 Forks 💻 JavaScript 📄 NOASSERTION 🏷 AI 7.5分

7.5AI 综合评分

AIMCPJavaScript

⚙️ 配置说明

📚 深度解析

本地AI助手是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装本地AI助手，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。本地AI助手提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将本地AI助手评为 AI 评分 7.5 分，属于同类工具中的优质选择。

📋 工具概览

本地AI助手是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 6

开发语言

JavaScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

NOASSERTION

AI 综合评分

7.5 分

工具类型

MCP工具

Forks

1

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

本地AI助手是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/OdysseyFather/lingxi

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "--ai--": {
      "command": "npx",
      "args": ["-y", "lingxi"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 本地AI助手 执行以下任务...
Claude: [自动调用 本地AI助手 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "__ai__": {
      "command": "npx",
      "args": ["-y", "lingxi"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 45/100 含工作流图查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

灵犀 AI Agent

本地优先的桌面 AI Agent 工作台 多模型 · 多智能体 · 人格蒸馏 · 深度 RAG · 屏幕操控 · Agent 互联 · 群聊协作 · 自我进化

<a href="README-EN.md">English</a> · <a href="#-为什么做灵犀">为什么做</a> · <a href="#-核心亮点">核心亮点</a> · <a href="#-能力全景">能力全景</a> · <a href="#-功能详解">功能详解</a> · <a href="#-快速开始">快速开始</a> · <a href="#-技术架构">架构</a> · <a href="#-支持项目">支持</a>

---

✨ 核心亮点

🔒 本地优先	会话、配置、知识库索引、进化日志全部存于本机 SQLite；API Key 走系统密钥链加密。可离线语音识别（内置 whisper.cpp），断网仍可使用本地模型。你的数据，始终是你的数据。
🤖 14+ 模型接入	Anthropic / OpenAI / DeepSeek / Qwen / Gemini / 豆包 / GLM / Kimi / Groq / Ollama… 内置 Bridge 协议翻译层，对话侧无感切换，一个工作台访问所有主流模型。
🧠 真正的 Agent	不是换 System Prompt 那么简单：每个智能体独立绑定技能包、RAG 知识库、MCP 工具、工作流；可自主调用 Bash、文件读写、浏览器；支持两阶段规划模式。
👤 人格蒸馏	集成 dot-skill：上传微信聊天记录、PDF、邮件等真实材料，蒸馏出同事、亲密关系、公众人物的沟通风格和人格特征，写入智能体。支持多人并行蒸馏。
🧬 自我进化	纠正、负反馈、有价值长对话自动提炼为长期记忆 / 知识文档 / 技能修复。全局扫描器 + 会话级触发；进化历程全程可审计、可搜索、单条可撤销。
🌐 Agent 互联	Project Nexus：局域网 mDNS + 广域网信令，跨设备 Agent 自动发现、一对一双向 token 级流式对话。人类可随时暂停、接管、审批，掌控权始终在你手中。
👥 微信风群聊	多 Agent 同群、人格驱动发言概率、@提及与引用回复、图片消息、撤回；更像真人在群里闲聊，而非 AI 轮流念稿。
🖥️ 屏幕感知	Screen Agent 截屏理解 → 操作规划 → 桌面操控（鼠标/键盘/滚动），每步确认，危险操作强制拦截。Spotlight 全局浮窗 + 剪贴板智能建议，主动在你正在做的事上帮忙。
📦 开箱即用	macOS `.dmg` / Windows 安装包，内嵌 Go 后端、Node、whisper.cpp、Claude CLI，无需 Docker，无需自建服务器，下载即用。

---

🗺️ 能力全景

flowchart TB subgraph Desktop["🖥️ Electron 桌面壳"] UI["React 19 · 6 套主题 · 流式 UI"] SP["Spotlight 悬浮窗 · 剪贴板监控"] SC["Screen Agent 桌面操控"] end subgraph Core["⚙️ Go 后端 · 本地 SQLite"] Chat["对话引擎 · 规划 · 工具链"] Agent["智能体工厂 · 人格蒸馏"] Evo["自我进化引擎 · 全局扫描"] RAG["向量索引 · 混合检索 · 文件监控"] Nexus["Project Nexus · 群聊 · 信令"] Job["定时任务 · IM Webhook"] Skill["技能管理 · MCP · 工作流"] end subgraph AI["🧠 AI 运行时"] CLI["Claude CLI"] Bridge["Go 协议转换代理"] WH["whisper.cpp 离线语音"] end UI --> Chat UI --> Agent UI --> Nexus Chat --> CLI CLI --> Bridge Chat --> RAG Agent --> Evo SP --> Chat SC --> Chat Job --> Chat Skill --> Chat

---

🎯 功能详解

以下每个模块都配有截图展示。已有截图直接显示，尚未截取的已留好位置，放入对应文件即可自动生效。

---

☕ 支持项目

如果灵犀对你有帮助，欢迎 Star 和打赏支持持续开发。

<img src="images/打赏.png" alt="微信打赏" width="280" /> 扫码打赏 · 支持持续迭代

---

<img src="logo.jpg" width="48" alt="灵犀" /> 灵犀 — 让 AI 成为你的工作伙伴，而不只是聊天对象。 如果对你有帮助，请 <a href="https://github.com/OdysseyFather/lingxi">Star ⭐</a>

📥 快速开始

仅 Windows（交叉编译）

./build-desktop.sh win


构建产物在 `dist-electron/` 目录：

dist-electron/ ├── mac-arm64/灵犀.app # 直接运行 ├── 灵犀-{version}-arm64.dmg # macOS 安装包 ├── 灵犀 Setup {version}.exe # Windows 安装包 └── 灵犀 {version}.exe # Windows 便携版


<details>
<summary><b>开发模式（三终端）</b></summary>

bash

🎬 更多截图画廊

<img src="images/agent ppt创作.png" alt="Agent PPT 创作" width="440" /> Agent 长任务 — PPT 创作实况

</td> <td width="50%">

<img src="images/规划推理.png" alt="规划推理" width="440" /> 规划模式 — 推理中间过程

</td> </tr> <tr> <td width="50%">

<img src="images/Agent 对话请求提问.png" alt="发起 A2A" width="440" /> Nexus — 发起 Agent 对话邀请

</td> <td width="50%">

<img src="images/Agent对话接收请求.png" alt="接收 A2A" width="440" /> Nexus — 接收方选择 Agent 响应

</td> </tr> </table>

---

🔧 技能 · MCP · 工作流 · 定时 · IM

灵犀不只是对话，它是一个完整的 Agent 平台。

技能管理

智能体的能力通过「技能」扩展。支持 AI 流式生成技能、ZIP 上传导入、在线查看/编辑技能文件、批量上传和导出。集成 Smithery.ai 技能市场，一键搜索和安装社区技能。

<img src="images/screenshots/15-skills-market.png" alt="技能管理" width="920" /> 技能管理 — AI 生成 · ZIP 导入 · Smithery 市场

<img src="images/skill安装.png" alt="技能安装" width="920" /> Smithery.ai 市场 — 搜索 · 分类 · 一键安装

MCP 工具管理

MCP（Model Context Protocol）让 Agent 调用外部工具。灵犀支持 stdio / SSE / HTTP 三种连接方式，可导入/导出配置，一键启用/禁用。

<img src="images/screenshots/16-mcp.png" alt="MCP" width="920" /> MCP 管理 — stdio / SSE / HTTP · 配置导出

可视化工作流

拖拽式节点编辑器，支持 6 种节点类型：提示词、条件分支、循环、延迟、代码执行、输出。将复杂任务编排为可视化流程，智能体按流程自动执行。

<img src="images/screenshots/14-workflow.png" alt="工作流" width="920" /> 可视化工作流编排 — 拖拽节点 · 连线 · 执行预览

定时任务

让 Agent 周期性自动执行任务：每 N 分钟/小时/每天/每周/每月/自定义 Cron。支持有状态模式（Agent 记忆上次执行内容）和无状态模式。执行完成后桌面通知推送，支持查看执行记录和跳转到对应会话。

<img src="images/screenshots/18-scheduled-tasks.png" alt="定时任务" width="920" /> 定时任务 — Cron 调度 · 执行记录 · 桌面通知 · WS 实时徽章

IM 连接器

将智能体接入企业微信、钉钉、飞书，通过 Webhook 响应即时消息，让你的 Agent 成为企业沟通中的智能节点。

<img src="images/screenshots/19-im-connector.png" alt="IM 连接器" width="920" /> IM 连接器 — 企业微信 · 钉钉 · 飞书

---

⚙️ 模型接入 · 用量统计

多模型统一接入

灵犀内置纯 Go 协议转换代理，你只需选择供应商、填写 API Key，即可无缝使用 14+ 供应商的模型。系统会自动获取可用模型列表供你选择，Base URL 已内置预设无需手动填写。支持接入点测试连通性、一键激活切换，激活后代理即时就绪（< 1ms），首次对话零等待。

<img src="images/screenshots/17-providers.png" alt="接入点" width="920" /> 模型接入点 — 14+ 供应商 · 测试连通 · 一键切换

<img src="images/llm.png" alt="模型供应商" width="920" /> 支持的模型供应商列表

用量与预算

精细到每次对话的 token 用量和费用统计，支持预算预警。非官方 API 使用本地定价表兜底估算（标注"~"提示）。

<img src="images/screenshots/20-usage.png" alt="用量" width="920" /> 用量统计 — token 计数 · 费用估算 · 预算预警

---

🎯 aiskill88 AI 点评 A 级 2026-05-27

高质量的开源MCP工具

📚 实用指南（长尾问题）

适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师
构建多智能体协作系统的 Agent 开发者
构建企业知识库 / RAG 检索应用的团队
跨境业务、多语言内容运营团队
做语音类 AI 产品的开发者

最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
Agent 任务先做 dry-run 验证工具调用链，再开启自主执行

常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
容器内无法访问宿主机 localhost — 使用 host.docker.internal
embedding 模型与查询模型不一致导致检索失效
显存不足直接 OOM — 优先降低 context 或换更小的量化模型

部署方案

Docker：lingxi 提供官方镜像，docker compose up 一键启动
CLI：直接 npm install -g / pip install，命令行调用
本地部署：CPU 8GB 起，GPU 推荐 16GB+ 显存
云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台

⚡ 核心功能

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

👥 适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师
构建多智能体协作系统的 Agent 开发者
构建企业知识库 / RAG 检索应用的团队
跨境业务、多语言内容运营团队

⭐ 最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
本地部署优先选 GGUF 量化模型，节省显存并保持响应速度
分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant

⚠️ 常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
容器内无法访问宿主机 localhost — 使用 host.docker.internal
embedding 模型与查询模型不一致导致检索失效

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点

+标准化 MCP 协议，生态互联性强
+与 Claude 官方生态无缝对接
+即插即用，配置简单快捷

⚠️ 不足

−依赖 Claude 客户端，非 Claude 用户无法使用
−MCP 协议仍在持续演进，接口可能变更
−需要一定的配置步骤

⚠️ 使用须知

该工具使用 NOASSERTION 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

📄 NOASSERTION — 请查阅原始协议条款了解具体使用限制。

🔗 相关工具推荐

📚 相关教程推荐

Cursor AI 编程完全指南：Rules 配置、Composer 使用、MCP 集成

帮助中心 · AI Skill Hub

MCP 工作流生产级配置方案：从开发环境到团队共享

📰 相关 AI 新闻

AI 前沿资讯：Is your AI strategy burning ca…

AI 资讯 · 知识关联

AI Agent 自主化能力最新进展

AI 资讯 · 知识关联

🍿 AI 圈相关吃瓜

配了5个 MCP 工具，Claude 一个都没用

AI 圈观察

Filesystem MCP 帮 Claude 找文件，找了整个 node_modules

AI 圈观察

AutoGPT 自主完成了任务：把我的文件夹全部重命名了

🗺️ 相关解决方案

ai-workflow-templates

translation

ai-translation-pipeline

🧩 你可能还需要

基于当前 Skill 的能力图谱，自动补全的工具组合

技能寻求者

MCP · Agent · 工作流

natively-cluely-ai-assistant — Claude Skill 中文使用文档

免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。

multi-agent-shogun Agent工作流

基于Claude的开源多智能体编排系统，采用武士风格架构设计，支持并行任务协调。适合需要构建复杂AI工作流、自动化多步骤任务的开发者和企业用

智能工作流

Agent · 工作流 · OCR

total-agent-memory MCP工具

为Claude Code和Codex CLI提供持久化记忆功能的开源MCP工具。自动提取知识图谱，支持多轮对话上下文保留，适合需要长期记忆和

cordum MCP工具

MCP · Agent · 工作流

❓ 常见问题 FAQ

lingxi 是什么工具？−

lingxi 是一款JavaScript开发的AI辅助工具。开源MCP工具：本地优先的桌面 AI Agent 工作台。接入 Anthropic、OpenAI、DeepSeek、Qwen、Gemini、豆包、GLM、Kimi、Groq。⭐6 · JavaScript 主要应用场景包括：桌面AI工作台。

lingxi 如何安装和开始使用？+

lingxi 是否免费？许可证是什么？+

lingxi 适合哪些用户使用？+

lingxi 的社区活跃度和项目维护状况如何？+

MCP 是什么？和普通 API 有什么区别？+

我需要编程基础才能使用这个 MCP 工具吗？+

这个工具支持 Claude Code 吗？还是只有 Claude Desktop？+

💡 AI Skill Hub 点评

总体来看，本地AI助手是一款质量良好的MCP工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

⬇️ 获取与下载

📚 深入学习本地AI助手

查看分步骤安装教程和完整使用指南，快速上手这款工具

⚙️ 安装教程 📚 使用教程

🌐 原始信息

原始名称	`lingxi`
原始描述	开源MCP工具：本地优先的桌面 AI Agent 工作台。接入 Anthropic、OpenAI、DeepSeek、Qwen、Gemini、豆包、GLM、Kimi、Groq。⭐6 · JavaScript
Topics	`AIMCPJavaScript`
GitHub	https://github.com/OdysseyFather/lingxi
License	NOASSERTION
语言	JavaScript

🔗 原始来源

🐙 GitHub 仓库 https://github.com/OdysseyFather/lingxi

收录时间：2026-05-27 · 更新时间：2026-05-30 · License：NOASSERTION · AI Skill Hub 不对第三方内容的准确性作法律背书。

本地AI助手

📚 深度解析

📋 工具概览

📖 中文文档

简介

灵犀 AI Agent

✨ 核心亮点

🗺️ 能力全景

🎯 功能详解

☕ 支持项目

📥 快速开始

仅 Windows（交叉编译）

🎬 更多截图画廊

🔧 技能 · MCP · 工作流 · 定时 · IM

技能管理

MCP 工具管理

可视化工作流

定时任务

IM 连接器

⚙️ 模型接入 · 用量统计

多模型统一接入

用量与预算

⚡ 核心功能

👥 适合人群

🎯 使用场景

⚖️ 优点与不足

🔗 相关工具推荐

❓ 常见问题 FAQ

🤖 交给 Agent 安装 · 本地AI助手