Freeagent

🚀 FreeAgent MCP サービス

FreeAgentの工数記録とタイマーを管理するためのClaude MCP（モデルコンテキストプロトコル）サーバーです。このサーバーを使用すると、ClaudeがあなたのFreeAgentアカウントとやり取りし、時間の追跡、タイマーの管理、工数記録操作の処理が可能になります。

✨ 主な機能

• ネストされたデータを持つ工数記録を一覧表示およびフィルタリング
• 新しい工数記録を作成
• 既存の工数記録を更新
• タイマーを開始および停止
• 工数記録を削除
• アクセストークンを自動的に更新
• 完全なエラー処理
• Docker サポート

🚀 クイックスタート

このセクションでは、FreeAgent MCP サービスを使用するための基本的な手順を説明します。

📦 インストール

前提条件

• Node.js 18+（Node.js を直接使用する場合）
• Docker および Docker Compose（コンテナ化して使用する場合）
• API アクセス権を持つ FreeAgent アカウント
• FreeAgent 開発者ダッシュボード から取得した OAuth 認証情報

インストール方法

オプション 1：Node.js を直接使用する場合

1. リポジトリをクローンします。

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

2. 依存関係をインストールします。

npm install

3. OAuth トークンを取得します。

# FreeAgent の認証情報を設定します。
export FREEAGENT_CLIENT_ID="your_client_id"
export FREEAGENT_CLIENT_SECRET="your_client_secret"

# アクセストークンを取得します。
curl -X POST "https://oauth2api.freeagent.com/v1/oauth/token" \
     -u "$FREEAGENT_CLIENT_ID:$FREEAGENT_CLIENT_SECRET" \
     -d "grant_type=client_credentials&scope=full Accounting"

オプション 2：Docker を使用する場合

1. リポジトリをクローンします。

git clone https://github.com/yourusername/freeagent-mcp.git
cd freeagent-mcp

2. Docker イメージをビルドします。

docker build -t freeagent-mcp .

3. コンテナを実行します。

docker run -p 3000:3000 --env-file .env freeagent-mcp

📚 ドキュメント

設定

環境変数

.env ファイルを作成し、以下の内容を追加します。

FREEAGENT_CLIENT_ID=your_client_id
FREEAGENT_CLIENT_SECRET=your_client_secret
PORT=3000

Docker の環境変数

docker-compose.yml で環境変数を設定します。

version: '3'
services:
  freeagent-mcp:
    image: freeagent-mcp
    ports:
      - "3000:3000"
    environment:
      - FREEAGENT_CLIENT_ID=your_client_id
      - FREEAGENT_CLIENT_SECRET=your_client_secret

使用方法

工数記録の一覧表示

curl http://localhost:3000/api/timeslips

工数記録の作成

curl -X POST "http://localhost:3000/api/timeslips" \
     -H "Content-Type: application/json" \
     -d '{"description":"プロジェクト会議","duration":60}'

工数記録の更新

curl -X PUT "http://localhost:3000/api/timeslips/123" \
     -H "Content-Type: application/json" \
     -d '{"description":"詳細なプロジェクト計画","duration":90}'

工数記録の削除

curl -X DELETE "http://localhost:3000/api/timeslips/123"

タイマーの制御

タイマーの開始

curl -X POST "http://localhost:3000/api/timers/123/start"

タイマーの停止

curl -X POST "http://localhost:3000/api/timers/123/stop"

開発

Node.js での開発

# プロジェクトをビルドします。
npm run build

# 変更を監視します。
npm run watch

# テストを実行します（実装されている場合）。
npm test

Docker での開発

# Docker イメージをビルドします。
docker build -t freeagent-mcp .

貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -am 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を開きます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。

ありがとう

• FreeAgent の素晴らしい API ドキュメント
• Claude チームの MCP SDK