Toshl MCP Server

🚀 Toshl MCP服务器

Toshl MCP服务器是一个用于将Toshl Finance与AI代理集成的MCP（模型上下文协议）服务器，它搭建起AI代理和Toshl Finance API之间的桥梁，让AI代理能访问财务数据、分析并给出见解。

🚀 快速开始

Toshl MCP服务器为AI代理和Toshl Finance API之间提供了连接。它允许AI代理访问Toshl的财务数据，进行分析并根据数据提供见解。

✨ 主要特性

对Toshl API的读取访问权限

• Toshl Finance：可以读取与Toshl Finance相关的数据。
• MCP资源：提供了对Toshl MCP资源的访问。
• MCP工具：提供了一系列用于与Toshl MCP交互的工具。

MCP资源

• 模型上下文协议资源：提供了与模型上下文协议相关的功能。
• 数据处理：支持对Toshl数据进行处理和分析。

MCP工具

• API调用：提供了与Toshl API交互的工具。
• 数据转换：支持将Toshl数据转换为其他格式以便于AI代理使用。

📦 安装指南

先决条件

要运行此服务器，您需要以下环境：

1. 安装Node.js（建议版本：v14或更高）
2. 安装npm（建议版本：6或更高）

获取API令牌

要获取Toshl API令牌，请按照以下步骤操作：

1. 访问Toshl官方网站。
2. 登录您的账户。
3. 转到“我的应用”部分。
4. 创建一个新的应用程序，并获取API令牌。

安装步骤

1. 克隆此仓库：

   git clone https://github.com/your-repository.git
   

2. 进入仓库目录：

   cd your-repository
   

3. 安装依赖项：

   npm install
   

🔧 技术细节

配置

创建一个.env文件，并添加以下内容：

TOSHL_API_TOKEN=your_api_token_here

服务器可以通过以下环境变量进行配置：

• TOSHL_API_TOKEN：您的Toshl API令牌。
• NODE_ENV：环境模式（默认：development）。

运行

1. 构建项目：

   npm run build
   

2. 启动服务器：

   npm start
   

项目结构

以下是项目的文件结构：

dist/                        # 编译后的JavaScript文件
.env                         # 环境变量文件
.env.example                 # 示例环境变量文件
package.json                 # 项目依赖
tsconfig.json                # TypeScript配置
src/
  └── main.ts               # 主程序入口

📄 许可证

本项目采用MIT许可证。