Specifai MCP Server について
Specifai MCP Serverは、Specifaiが生成したプロジェクト文書をMCP対応AIツールから参照できるようにします。文書取得、タスク検索、全文検索に対応し、現在は実験段階です。
主な機能
- 01業務・製品要件文書の取得
- 02非機能・UI要件の取得
- 03業務プロセス文書とテストケースの取得
- 04ユーザーストーリーとタスクの照会
- 05文書全体の全文検索
活用シーン
- 01IDEでプロジェクト要件を確認
- 02ユーザーストーリーに関連するタスクを確認
- 03Specifaiのプロジェクト文書を検索
- 04IDでタスクの詳細を参照
MCP 対応
Specifaiの文書取得、検索、タスク操作ツールをMCPクライアントに公開し、Hai BuildやCursorなどと連携します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
13掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| cwd | string | はい | ツールの呼び出し元の絶対パスで、`.specifai-path` ファイルを含み、specifai プロジェクトのパスを自動推定するために使用されます。このパスは、ツールの呼び出し元の現在の作業ディレクトリ(cwd)になります。 |
| includeDescription | boolean | いいえ | 出力に説明を含めます。デフォルトは false です |
| limit | number | いいえ | 返すドキュメント数を制限します。デフォルトは 10 です |
| offset | number | いいえ | 返すドキュメント数のオフセット。デフォルトは 0 です |
詳細
Specifai MCP サーバー
MCPプロジェクトを統合し、MCP 対応のあらゆる AI ツールで自動化するための Model Context Protocol(MCP)サーバーです。このサーバーは特定のツールに依存しない設計であり、MCP プロトコルに対応するあらゆるツールで使用できます。現在、このサーバーは Specifai プロジェクトが生成したすべてのドキュメントを読み取るツールを公開しています。
警告
このサーバーは現在、実験段階です。サーバーの開発と改善を続けるなかで、機能や利用可能なツールは変更・拡張される可能性があります。
目次
要件
- Node.js >= 16.0.0
- Bun >= 1.0.0(Bun ランタイムを使用する場合)
- Hai Build、Cursor、Windsurf、Claude Desktop、または任意の MCP クライアント
インストール
# Latest version
npx --yes @presidio-dev/specifai-mcp-server@latest
# Specific version
npx --yes @presidio-dev/[email protected]
サーバーのインストールには npx を推奨しますが、yarn、pnpm、bun など、お好みの Node パッケージマネージャーを使用することもできます。
設定
最新バージョンを npx で使用する場合:
{
"specifai": {
"command": "npx",
"args": ["--yes", "@presidio-dev/specifai-mcp-server@latest"],
"disabled": false,
"autoApprove": []
}
}
特定のバージョンを npx で使用する場合:
{
"specifai": {
"command": "npx",
"args": ["--yes", "@presidio-dev/[email protected]"],
"disabled": false,
"autoApprove": []
}
}
プロジェクトの準備
これは完全に任意ですが、サーバーにアクセスするたびにプロジェクトディレクトリのパスを指定する手間を省くため、使用をおすすめします。AI IDE/拡張機能(Hai Build)では、プロジェクトディレクトリのパスを指定するために
.specifai-pathファイルを使用することをおすすめします。
プロジェクトのルートディレクトリに .specifai-path ファイルがあることを確認してください。このファイルを使って、Specifai MCP サーバーは Specifai が生成した仕様ドキュメントの保存場所を特定します。
このファイルは、プロジェクトの仕様ドキュメントが保存されているプロジェクトディレクトリの絶対パスを記載したプレーンテキストファイルです。
たとえば、プロジェクトディレクトリが /path/to/project にある場合、.specifai-path ファイルには次の行を記載します。
/path/to/project
人気の IDE および拡張機能との Specifai MCP 統合
それぞれのセットアップ手順を確認してください。
Hai Build にインストール
以下を hai_mcp_settings.json ファイルに追加します。Hai Build からこのファイルを開くには、「MCP Servers」アイコンをクリックし、「Installed」タブを選択してから、「Configure MCP Servers」をクリックします。
詳しくは、Hai Build MCP のドキュメントを参照してください。
{
"mcpServers": {
"specifai": {
"command": "npx",
"args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
Amazon Q Developer にインストール
以下を Amazon Q Developer の設定ファイルに追加します。詳しくは、IDE での Q Developer 向け MCP 設定を参照してください。
設定ファイルは、すべてのプロジェクトで利用できるように ~/.aws/amazonq/mcp.json にグローバルに保存するか、プロジェクト内の .amazonq/mcp.json に保存できます。
{
"mcpServers": {
"specifai": {
"command": "npx",
"args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
VS Code(Copilot)にインストール
まず、設定(Ctrl+,)を開き、mcp.enabled を検索してチェックボックスにチェックを入れ、VS Code で MCP サポートを有効にします。
次に、以下の設定をユーザーまたはワークスペースの settings.json ファイルに追加します。詳しくは、VS Code MCP のドキュメントを参照してください。
"mcp": {
"servers": {
"specifai": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
Cursor にインストール
最も簡単なインストール方法は、以下のワンクリックインストールボタンを使うことです。
または、以下を mcp.json ファイルに追加して、サーバーを手動で設定できます。このファイルは、グローバルな ~/.cursor/mcp.json または特定のプロジェクト内の .cursor/mcp.json に配置できます。詳しくは、Cursor MCP のドキュメントを参照してください。
{
"mcpServers": {
"specifai": {
"command": "npx",
"args": ["--yes", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
Windsurf にインストール
以下を ~/.codeium/windsurf/mcp_config.json ファイルに追加します。詳しくは、Windsurf MCP のドキュメントを参照してください。
{
"mcpServers": {
"specifai": {
"command": "npx",
"args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
Zed にインストール
settings.json ファイル(zed: settings アクションからアクセスできます)を編集するか、Agent Panel の設定 UI(agent: open configuration)を使って、Zed に Specifai MCP サーバーを追加できます。詳しくは、Zed MCP のドキュメントを参照してください。
以下を settings.json に追加します。
{
"context_servers": {
"specifai": {
"command": {
"path": "npx",
"args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
}
}
}
}
このサーバーでは、仕様ドキュメントを操作するための複数のツールを利用できます。
| ツール名 | 説明 |
|---|---|
get-brds | ビジネス要件ドキュメントを取得します |
get-prds | 製品要件ドキュメントを取得します |
get-nfrs | 非機能要件を取得します |
get-uirs | ユーザーインターフェース要件を取得します |
get-bpds | ビジネスプロセスドキュメントを取得します |
get-tcs | テストケースドキュメントを取得します |
get-user-stories | 特定の PRD のユーザーストーリーを取得します |
get-tasks | 特定のユーザーストーリーのタスクを取得します |
get-task | 特定のタスクの詳細を取得します |
set-project-path | プロジェクトディレクトリのパスを設定または変更します |
get-task-by-id | ID を指定して特定のタスクの詳細を取得します |
list-all-tasks | 利用可能なすべてのタスクを一覧表示します |
search | すべてのドキュメントを対象に全文検索します |
コントリビューション
Specifai MCP Server へのコントリビューションを歓迎します!始め方については、コントリビューションガイドをご覧ください。
開発環境のセットアップ
開発環境のセットアップ手順について詳しくは、開発環境セットアップガイドをご覧ください。
アーキテクチャ
プロジェクトのアーキテクチャについては、アーキテクチャガイドをご覧ください。
セキュリティ
セキュリティポリシーおよびセキュリティ上の脆弱性の報告方法については、セキュリティポリシーをご覧ください。
ライセンス
このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSEファイルをご覧ください。
謝辞
- Model Context Protocol - このサーバーが実装するプロトコル仕様
- Specifai - このサーバーが連携するプロジェクト
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。