mcp-invest-assistant/README.md

MCP投资助手服务器

# 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

1. 打开[理杏仁](https://www.lixinger.com/) ，登录，
  新注册的用户，每个api有免费1000次的体验机会，使用一年左右足够，如果需要更多次数可以更换其他账号，或者去淘宝购买年会员预计88/年；
2. 进入[token获取页](https://www.lixinger.com/open/api/token)，复制；
3. 将token复制粘贴到配置中的{YOUR_TOKEN}位置即可；

###  🔧 配置 MCP 客户端

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

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

2. 配置 Claude 的 MCP 配置文件

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

> **注意**: 请确保使用 `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
```
找一个Host配置好MCP
```json
{
    "mcpServers": {
        "mcp-invest-assistant": {
          // 参考这个，应该是你的路径
            "args": [
                "/Users/haohongyang/Documents/mymcpserver/mcp-invest-assistant"
            ],
            "command": "node",
            "disabled": false,
            "env": {
                "TOKEN": "95f5c7f5-3a20-436e-a411-011dc2eff608"
            }
        }
    }
}
```


## 项目结构

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