ashra-mcp | 妙悟AI

Ashra MCP

这是一个专为 Ashra 项目设计的模型上下文协议（Model Context Protocol, MCP）服务器。通过实现 MCP，Ashra MCP 使得 Ashra 的功能或上下文能够被支持该协议的第三方应用（如 Claude 桌面版）调用和利用，从而增强这些应用与 Ashra 的集成能力和用户体验。它充当了 Ashra 服务与 AI 模型应用之间的桥梁。

主要功能和特点：

MCP 协议实现： Ashra MCP 符合模型上下文协议规范，能够接收来自兼容应用的请求，并将这些请求转发给 Ashra 服务进行处理，然后将结果返回给应用。
与 Claude 集成： 提供了详细的配置指南，使用户能够将 Ashra MCP 作为外部服务无缝集成到 Claude 桌面应用中。
基于 Node.js： 服务器使用 Node.js 环境运行，便于部署和管理。
环境变量配置： 支持通过环境变量（如 ASHRA_API_KEY）安全地配置敏感信息，提高了安全性。

使用方法：

要运行 Ashra MCP 服务器，需要执行以下步骤：

安装依赖： 在项目根目录下运行 yarn 命令，安装项目所需的所有 Node.js 包依赖。
bash yarn
构建项目： 运行 yarn build 命令。此命令会编译源代码或执行必要的构建步骤，生成最终可执行的服务器文件，通常位于 build 目录下（例如 build/index.js）。
bash yarn build

Claude 配置：

为了让 Claude 桌面应用能够连接并使用 Ashra MCP 服务器，需要进行特定的配置：

下载 Claude： 确保已安装最新版本的 Claude 桌面应用。
找到或创建配置文件： 导航到 Claude 的应用支持目录，找到或手动创建名为 claude_desktop_config.json 的配置文件。在 macOS 系统中，该文件通常位于 ~/Library/Application\ Support/Claude/ 路径下。
编辑配置文件： 打开 claude_desktop_config.json 文件，添加或修改 mcpServers 部分，使其包含一个名为 ashra 的配置条目，结构如下：
json { "mcpServers": { "ashra": { "command": "node", // 或者，如果您使用 nvm 且需要指定特定版本的 node 路径： // "command": "/Users/<您的用户名>/.nvm/versions/node/<版本号>/bin/node", "args": [ "<到 ashra-mcp 目录的路径>/build/index.js" ], "env": { "ASHRA_API_KEY": "<您的 Ashra API 密钥>" } } } }
- 请将 <到 ashra-mcp 目录的路径> 替换为你实际存放 Ashra MCP 项目的绝对路径。
- 将 <您的 Ashra API 密钥> 替换为你从 Ashra 服务获得的真实 API 密钥。这是服务器连接 Ashra 服务进行认证和交互所必需的。
- command 指定了运行服务器的命令，通常直接使用系统默认的 node 即可。如果环境复杂或需要指定特定 Node.js 版本，可以使用完整的 Node.js 可执行文件路径。
- args 数组中包含了传递给 command 的参数，这里是服务器启动脚本的路径。
- env 对象用于设置环境变量，在这里用于传递 ASHRA_API_KEY。