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許可證。