EVE Online OSINT MCP

🚀 FastMCP Boilerplate

このBoilerplateは、FastMCP のためのものです。MCPサーバーを構築する際の良いスタート地点となります。テスト、リント、フォーマット、そしてNPMへの公開のための基本的なセットアップが含まれています。

🚀 クイックスタート

まずは、リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/punkpeye/fastmcp-boilerplate.git
cd fastmcp-boilerplate
npm install
npm run dev

⚠️ 重要提示

新しいプロジェクトを始める場合は、fastmcp-boilerplate をフォークしてそこから始めることをおすすめします。

サーバーの起動

サーバーを単純に起動するだけの場合は、start スクリプトを使用できます。

npm run start

ただし、dev スクリプトを使用することで、サーバーと対話することもできます。

npm run dev

これによりサーバーが起動し、CLIを使ってサーバーと対話できるようになります。

テスト

良いMCPサーバーにはテストが必要です。ただし、MCPサーバー自体をテストするのではなく、実装したツールをテストする必要があります。

npm run test

このBoilerplateの場合は、add ツールの実装のみをテストしています。

リント

適切なリント設定をすることで、他の開発者がプロジェクトに貢献する際の摩擦を減らすことができます。

npm run lint

このBoilerplateでは、Prettier、ESLint、そして TypeScript ESLint を使用してコードをリントしています。

フォーマット

コードをフォーマットするには、npm run format を使用します。

npm run format

GitHub Actions

このリポジトリには、GitHub Actionsのワークフローがあり、リント、フォーマット、テストを実行し、semantic-release を使用してNPMにパッケージの更新を公開します。

このワークフローを使用するには、以下のことが必要です。

1. NPM_TOKEN をリポジトリのシークレットに追加する
   1. 新しい自動化トークンを作成する
   2. トークンを NPM_TOKEN 環境シークレットとして追加する（Settings → Secrets and Variables → Actions → "Manage environment secrets" → "release" → Add environment secret）
2. ワークフローに書き込みアクセス権を付与する（Settings → Actions → General → Workflow permissions → "Read and write permissions"）