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
。
- 请将
完成以上配置后,启动或重启 Claude 桌面应用,它应该就能检测到并连接到 Ashra MCP 服务器,从而可以在 Claude 内部使用 Ashra 提供的模型上下文功能了。
故障排除:
如果在安装、配置或使用过程中遇到任何问题,建议查阅模型上下文协议(MCP)服务器相关的官方文档。该文档通常包含更详细的技术说明、常见问题解答和故障排除步骤,能够提供进一步的帮助。
数据统计
相关导航
暂无评论...