Toshl MCP Server

🚀 Toshl MCP サーバー

Toshl MCPサーバーは、Toshl FinanceとAIエージェントを統合するためのMCP（モデルコンテキストプロトコル）サーバーです。このサーバーにより、AIエージェントがToshlの財務データにアクセスし、データを分析して洞察を得ることが可能になります。

🚀 クイックスタート

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

実行

1. プロジェクトをビルドします。

   npm run build
   

2. サーバーを起動します。

   npm start
   

プロジェクト構造

以下は、プロジェクトのファイル構造です。

dist/                        # コンパイル後のJavaScriptファイル
.env                         # 環境変数ファイル
.env.example                 # 環境変数ファイルの例
package.json                 # プロジェクトの依存関係
tsconfig.json                # TypeScriptの設定
src/
  └── main.ts               # メインプログラムのエントリーポイント

設定

サーバーは、以下の環境変数を使用して設定することができます。

📄 ライセンス

MIT