AI导哈

AI搜索协议服务器

AXYS MCP Lite是一款提供AI驱动的搜索功能的协议服务器，支持通过自然语言命令搜索结构化和非结构化数据。

  • by sonyjoy-siliconvalleycloudit
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sonyjoy-siliconvalleycloudit/axys-mcp-lite

使用说明

AXYS MCP Lite

一个模型上下文协议（MCP）服务器，提供人工智能驱动的搜索功能，使克劳德等人工智能助手能够使用自然语言命令搜索结构化和非结构化数据。

特性

  • 人工智能驱动的结构化搜索：结构化数据库上的自然语言查询
  • 人工智能驱动的非结构化搜索：使用自然语言搜索文档、视频和文件
  • 语义搜索：AI理解上下文和含义以获得更好的结果
  • 多种内容类型：搜索PDF、Word文档、视频、图像等
  • 安全认证：用于安全访问的基于API密钥的身份验证

先决条件

  • Node.js 18或更高版本
  • MCP API密钥
  • Claude Desktop应用程序或任何兼容MCP的客户端

安装

通过npm（推荐）

npm install -g axys-mcp-lite

来源

git clone https://github.com/rajesh-siliconvalleycloudit/axys-mcp-lite.git
cd axys-mcp-lite
npm install
npm run build

快速开始

1.获取MCP API密钥

请与管理员联系以获取MCP API密钥。

2.配置克劳德桌面

将此配置添加到您的Claude Desktop配置文件中：

在macOS上: ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "axys-mcp-lite": {
      "command": "npx",
      "args": ["-y", "axys-mcp-lite"],
      "env": {
        "AXYS_API_HOST": "https://your-axys-host.com",
        "MCP_KEY": "your-mcp-key-here"
      }
    }
  }
}

3.重新启动克劳德桌面

重新启动Claude Desktop以加载MCP服务器。你现在应该可以使用AI搜索命令了！

可用工具

1. ai_search_structured

使用自然语言搜索结构化数据源。

参数：

  • query （必填）：自然语言查询

例子：

Find all users in engineering department

2. ai_search_unstructured

使用自然语言搜索文档、视频和文件。

参数：

  • query （必填）：自然语言查询
  • searchIndices （可选）：要搜索的特定索引（例如，“视频”、“文档”）
  • fileOnly （可选）：仅返回没有内容的文件引用

例子：

Find deployment documentation videos

3. validate_connection

验证与MCP API的连接。

使用示例

结构检索

"Find all employees named John"
"Show customers with revenue over $1M"
"List users in the Sales department"

非结构化搜索

"How to install AXYS?"
"Find videos about API integration"
"Search for architecture diagrams"

配置选项

环境变量

创建一个 .env 项目目录中的文件：

# Required
AXYS_API_HOST=https://your-axys-host.com
MCP_KEY=your-mcp-key-here

# Optional: Logging configuration
LOG_LEVEL=info

发展

本地运行

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

项目结构

axys-mcp-lite/
├── src/
│   ├── index.ts        # Main MCP server implementation
│   ├── axys-client.ts  # API client wrapper
│   └── types.ts        # TypeScript type definitions
├── dist/               # Compiled JavaScript output
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

故障排除

连接问题

  • 验证 AXYS_API_HOST URL正确
  • 检查MCP_KEY是否有效且处于活动状态
  • 确保与API服务器的网络连接

没有结果

  • 尝试重新表述您的查询
  • 检查系统中是否存在数据
  • 验证您的API密钥是否具有适当的权限

API响应代码

代码 描述
200 成功
201 未配置AI工具
401 API密钥无效
402 错误请求
500 内部服务器错误

安全最佳实践

  1. 永远不要提交API密钥 到版本控制
  2. 使用环境变量 用于敏感配置
  3. 定期旋转API键 出于安全考虑
  4. 监控API使用情况 不寻常的活动

贡献

欢迎投稿！请随时提交拉取请求。

  1. 复刻仓库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

支持

对于问题：

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

更新日志

版本1.0.0

  • 初始版本
  • 人工智能驱动的结构化搜索
  • 人工智能驱动的非结构化搜索（文档、视频、文件）
  • 连接验证工具

精心为MCP社区打造

相关 MCP