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 スクリプトを使用することで、サーバーとCLIを通じて対話することもできます。

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"）。