mcpField
S
Specifai MCP Server

Specifai MCP Server

ローカル
github.com/presidio-oss開発ツール1365 週間前に更新

Specifai MCP Server について

Specifai MCP Serverは、Specifaiが生成したプロジェクト文書をMCP対応AIツールから参照できるようにします。文書取得、タスク検索、全文検索に対応し、現在は実験段階です。

主な機能

  1. 01業務・製品要件文書の取得
  2. 02非機能・UI要件の取得
  3. 03業務プロセス文書とテストケースの取得
  4. 04ユーザーストーリーとタスクの照会
  5. 05文書全体の全文検索

活用シーン

  1. 01IDEでプロジェクト要件を確認
  2. 02ユーザーストーリーに関連するタスクを確認
  3. 03Specifaiのプロジェクト文書を検索
  4. 04IDでタスクの詳細を参照

MCP 対応

Specifaiの文書取得、検索、タスク操作ツールをMCPクライアントに公開し、Hai BuildやCursorなどと連携します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"specifai": {
"command": "npx",
"args": [
"-y",
"@presidio-dev/specifai-mcp-server"
]
}
}
}
起動コマンドnpx -y @presidio-dev/specifai-mcp-server

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@presidio-dev/specifai-mcp-server

ツール

13

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
cwdstringはいツールの呼び出し元の絶対パスで、`.specifai-path` ファイルを含み、specifai プロジェクトのパスを自動推定するために使用されます。このパスは、ツールの呼び出し元の現在の作業ディレクトリ(cwd)になります。
includeDescriptionbooleanいいえ出力に説明を含めます。デフォルトは false です
limitnumberいいえ返すドキュメント数を制限します。デフォルトは 10 です
offsetnumberいいえ返すドキュメント数のオフセット。デフォルトは 0 です

詳細

Specifai MCP サーバー

License: MIT npm version VS Code にインストール(npx) VS Code Insiders にインストール(npx) Cursor にインストール(npx)

Hai Build Amazon Q VS Code Cursor Windsurf Zed

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)にインストール

VS Code にインストール(npx) VS Code Insiders にインストール(npx)

まず、設定(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 にインストール

最も簡単なインストール方法は、以下のワンクリックインストールボタンを使うことです。

Cursor にインストール(npx)

または、以下を 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-idID を指定して特定のタスクの詳細を取得します
list-all-tasks利用可能なすべてのタスクを一覧表示します
searchすべてのドキュメントを対象に全文検索します

コントリビューション

Specifai MCP Server へのコントリビューションを歓迎します!始め方については、コントリビューションガイドをご覧ください。

開発環境のセットアップ

開発環境のセットアップ手順について詳しくは、開発環境セットアップガイドをご覧ください。

アーキテクチャ

プロジェクトのアーキテクチャについては、アーキテクチャガイドをご覧ください。

セキュリティ

セキュリティポリシーおよびセキュリティ上の脆弱性の報告方法については、セキュリティポリシーをご覧ください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSEファイルをご覧ください。

謝辞

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。