# Claude专家服务器
## 基本信息
- Slug: `crazyrabbitltc-mcp-expert-server`
- Source: modelscope
- Publisher: @crazyrabbitLTC/mcp-expert-server
- Categories: developer-tools / cloud-platforms / knowledge-and-memory
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@crazyrabbitLTC/mcp-expert-server
## 简介
一个利用Claude AI生成智能查询并根据API文档分析提供文档协助的模型上下文协议服务器。
## 安装提示

```bash
npm install
```

## MCP Server 详情

# MCP 专家服务器

这是一个使用 Claude AI 提供智能查询生成和文档辅助的模型上下文协议服务器。该服务器分析您的 API 文档并提供两个主要工具：

- **create-query**: 根据自然语言请求生成查询
- **documentation**: 根据问题提供相关的文档信息

## 先决条件

- Node.js >= 18
- 用于 Claude 的 Anthropic API 密钥

## 安装

1. 克隆仓库
2. 安装依赖项：
```bash
npm install
```
3. 创建一个包含您的 Anthropic API 密钥的 `.env` 文件：
```
ANTHROPIC_API_KEY=your_api_key_here
```


## 设置

在运行服务器之前，您需要：

1. 构建项目并运行设置脚本：
```bash
npm run build
npm run setup
```


这将：
- 创建所需的目录（`docs/` 和 `prompts/`）
- 创建默认的提示文件
- 生成初始的服务描述

2. 将您的 API 文档文件添加到 `docs/` 目录中（支持 `.txt`、`.md` 和 `.json` 文件）

3. 可选地自定义 `prompts/` 目录中的提示：
   - `system-prompt.txt`: Claude 的主系统提示
   - `tool-metadata.txt`: 工具描述的附加上下文
   - `query-metadata.txt`: 查询生成的附加上下文
   - `service-description.txt`: 自动生成的服务描述

## 使用

### 独立服务器

启动服务器：
```bash
npm start
```


服务器通过模型上下文协议暴露两个工具：

- **create-query**: 根据自然语言请求生成查询
  ```json
  {
    "name": "create-query",
    "arguments": {
      "request": "查找上周注册的所有用户"
    }
  }
  ```

- **documentation**: 从文档中获取信息
  ```json
  {
    "name": "documentation",
    "arguments": {
      "request": "如何验证 API 请求？"
    }
  }
  ```

### Claude 桌面集成

1. 将此配置添加到您的 Claude 桌面配置文件中：
```json
{
  "mcpServers": {
    "expert": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}
```


2. 将 `/ABSOLUTE/PATH/TO/expert-server` 替换为实际的服务器安装绝对路径。

3. 重启 Claude 桌面应用程序。

## 目录结构

```
.
├── docs/                  # Your API documentation files
├── prompts/              # System prompts and metadata
│   ├── system-prompt.txt    # Main system prompt
│   ├── tool-metadata.txt    # Tool description context
│   ├── query-metadata.txt   # Query generation context
│   └── service-description.txt  # Generated service description
├── src/                  # Source code
│   ├── index.ts            # Entry point
│   ├── server.ts           # MCP server implementation
│   └── services/           # Core services
│       └── expertService.ts  # Claude integration
└── package.json
```


## 开发

- 构建项目：
```bash
npm run build
```


- 服务器使用 TypeScript 并遵循模块化架构
- 所有与 Claude 的交互都由 ExpertService 类处理
- 调试日志以 [DEBUG] 前缀写入 stderr

## 故障排除

如果您遇到连接问题：

1. 确保您已运行设置脚本：
```bash
npm run setup
```


2. 检查 `prompts/` 目录中是否存在所有必需的文件
3. 验证您的 `ANTHROPIC_API_KEY` 是否正确设置
4. 在 Claude 桌面配置中使用绝对路径
5. 检查调试日志（写入 stderr）

## 环境变量

- `ANTHROPIC_API_KEY`: 您的 Anthropic API 密钥（必需）

## 许可证

MIT