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 department2. ai_search_unstructured
使用自然语言搜索文档、视频和文件。
参数：
query（必填）：自然语言查询searchIndices（可选）：要搜索的特定索引（例如，“视频”、“文档”）fileOnly（可选）：仅返回没有内容的文件引用
例子：
Find deployment documentation videos3. 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_HOSTURL正确 - 检查MCP_KEY是否有效且处于活动状态
- 确保与API服务器的网络连接
没有结果
- 尝试重新表述您的查询
- 检查系统中是否存在数据
- 验证您的API密钥是否具有适当的权限
API响应代码
| 代码 | 描述 |
|---|---|
| 200 | 成功 |
| 201 | 未配置AI工具 |
| 401 | API密钥无效 |
| 402 | 错误请求 |
| 500 | 内部服务器错误 |
安全最佳实践
- 永远不要提交API密钥 到版本控制
- 使用环境变量 用于敏感配置
- 定期旋转API键 出于安全考虑
- 监控API使用情况 不寻常的活动
贡献
欢迎投稿！请随时提交拉取请求。
- 复刻仓库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
支持
对于问题：
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
致谢
- 内置于 模型上下文协议SDK
- 专为与Claude Desktop和其他MCP客户端一起使用而设计
更新日志
版本1.0.0
- 初始版本
- 人工智能驱动的结构化搜索
- 人工智能驱动的非结构化搜索（文档、视频、文件）
- 连接验证工具
______________________________________________________________________
精心为MCP社区打造