# MCP 投资助手 (mcp-invest-assistant)

一个基于 Model Context Protocol (MCP) 的投资助手服务器，提供 ETF 指数温度计算功能，帮助投资者进行更明智的投资决策。

## 项目简介

MCP 投资助手是一个专为投资者设计的辅助工具，通过计算指数温度来评估市场状态，帮助用户判断 ETF 买入卖出时机。该项目基于 Node.js 和 TypeScript 开发，使用 Model Context Protocol 标准与 AI 助手进行通信。

## 功能特点

- **ETF 温度计算**：基于 PE 和 PB 分位数计算指数综合温度（0-100），帮助判断市场状态
- **多市场支持**：支持 A 股、港股、美股等多个市场的指数温度计算
- **MCP 标准接口**：符合 Model Context Protocol 标准，可与支持 MCP 的 AI 助手无缝集成

## 指数温度指标解读

指数温度是一个介于 0-100 之间的数值，反映市场的整体估值水平：

- **0-10°**：市场处于寒冬期，估值极低，是最佳买入时机
- **10-20°**：市场开始回暖，仍是良好的买入机会
- **20-30°**：市场状态良好，可继续买入
- **30-40°**：市场趋热，可继续持有但需警惕风险
- **40-50°**：市场较热，考虑逐步卖出
- **>90°**：市场过热，随时有大幅回调风险

## 它能帮你做什么
### 快速开始
TODO 这里录制一个使用视频和投资视频


## 安装与配置
### 配置理杏仁token

###  🔧 配置 MCP 客户端

1. 安装 MCP 投资助手服务器

```bash
npm install -g mcp-invest-assistant
```

2. 配置 Claude 的 MCP 配置文件

```json
{
  "mcpServers": {
    "mcp-invest-assistant": {
      "command": "mcp-invest-assistant",
      "args": []
    }
  }
}
```

> **注意**: 请确保使用 `mcp-invest-assistant` 而非 `npx`。使用全局安装的包可以避免一些连接问题。

3. 如果你仍然看到 `Connection closed` 错误，请尝试以下解决方案：

   - 检查你的防火墙设置是否阻止了进程通信
   - 尝试重启你的编辑器或 Claude 客户端
   - 检查 `~/Documents/mymcpserver/mcp-invest-assistant/logs` 目录中的日志文件以获取更详细的错误信息


## 安装与调试

### 前置条件

- Node.js 16.0 或更高版本
- npm 7.0 或更高版本

### 安装步骤

1. 克隆仓库
```bash
git clone <repository-url>
cd mcp-invest-assistant
```

2. 安装依赖
```bash
npm install
```

3. 构建项目
```bash
npm run build
```

4. 启动服务
```bash
npm start
```

开发模式启动（支持热重载）：
```bash
npm run dev
```

## 项目结构

```
mcp-invest-assistant/
├── dist/                # 编译后的 JavaScript 文件
├── src/                 # 源代码
│   ├── config/          # 配置文件
│   ├── services/        # 服务层，包含数据获取和处理逻辑
│   ├── tools/           # MCP 工具定义
│   ├── types/           # TypeScript 类型定义
│   ├── utils/           # 工具函数
│   └── index.ts         # 应用入口文件
├── package.json         # 项目依赖和脚本
└── tsconfig.json        # TypeScript 配置
```