find-mcp-server-ja

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Find MCP Server JA（MCPサーバーの検索と導入）

Find MCP Server JA (Discovery and Installation of MCP Servers)

このスキルは、目的に合う公開MCPサーバーを見つけ、候補比較、導入、導入後の基本テストまでを一貫して支援します。

This skill provides end-to-end support for finding public MCP servers that meet your needs, comparing candidates, installing them, and performing basic post-installation tests.

使うタイミング

When to Use

「Xと連携できるMCPサーバーはあるか」「X用のMCPツールを探して」と依頼されたとき
エージェントに新しい外部連携を追加したいとき
既存のサービスやシステムをAIエージェントから操作したいとき

When asked "Is there an MCP server that integrates with X?" or "Find MCP tools for X"
When you want to add new external integrations to an agent
When you want to operate existing services or systems from an AI agent

主なコマンド

Main Commands

script/

は

SKILL.md

と同じ階層に置き、まず同梱CLIで候補探索します。実行時はスキルのディレクトリに移動するか、

SKILL.md

から見た相対位置で

script/mcp-server-search.js

を解決します。現在のカレントディレクトリを前提にしません。

```
node script/mcp-server-search.js [検索語] --limit 30
```
: Official MCP Registry、Smithery REST API、GitHub REST API を並列検索して統一JSONを返す
```
npx add-mcp [npmパッケージ名]
```
: npmパッケージ型のMCPサーバーを追加する
```
npx add-mcp "[実行コマンド 引数1 ...]"
```
: stdio型のMCPサーバーを追加する。引用した実行コマンドには半角スペースを1つ以上含める
```
npx add-mcp [HTTP URL]
```
: URLから直接追加する

npx add-mcp find

は使わないでください。見つけた候補をそのままワークスペースへ追加してしまいます。

Place

script/

in the same directory as

SKILL.md

, and first use the bundled CLI to search for candidates. When executing, either move to the skill directory or resolve

script/mcp-server-search.js

using its relative path from

SKILL.md

. Do not assume the current working directory.

```
node script/mcp-server-search.js [search term] --limit 30
```
: Searches the Official MCP Registry, Smithery REST API, and GitHub REST API in parallel and returns unified JSON
```
npx add-mcp [npm package name]
```
: Adds an npm package-type MCP server
```
npx add-mcp "[execution command argument1 ...]"
```
: Adds a stdio-type MCP server. The quoted execution command must contain one or more half-width spaces
```
npx add-mcp [HTTP URL]
```
: Adds directly from a URL

Do not use

npx add-mcp find

; it will add the found candidates directly to the workspace.

ワークフロー

Workflow

1. 要件確認

1. Requirement Confirmation

次の2点を確認します。

連携対象。例: PostgreSQL、GitHub、Slack、Notion
実行したい操作。例: クエリ、PR作成、Issue作成、メッセージ送信

Confirm the following two points:

Integration target. Examples: PostgreSQL, GitHub, Slack, Notion
Desired operations. Examples: Querying, PR creation, Issue creation, message sending

2. 候補検索

2. Candidate Search

まずは同梱CLIを使います。

bash

node script/mcp-server-search.js github --limit 30

同じJSON出力から、少なくとも次を直接確認します。

```
sources.registry.ok
```
```
sources.smithery.ok
```
```
sources.github.ok
```
```
merged[]
```
```
normalized[]
```

検索時のルール:

3ソース確認済みと言ってよいのは、その実行のJSONで
```
sources.registry.ok
```
、
```
sources.smithery.ok
```
、
```
sources.github.ok
```
がすべて
```
true
```
の場合だけ
3ソース確認の根拠は、最終的に採用した同梱CLI 1回分のJSONだけに置きます。絞り込みで再実行した場合は、確認済みとして引用するのは最後の実行結果だけにします
README、別API実行、GitHub検索をつなぎ合わせて「3ソース確認済み」と扱わない
どれかが
```
false
```
または未確認なら、その事実を明示し、以降は補助調査として扱う
検索語が広すぎる場合は、3ソース確認を維持したまま絞り直してよい。その場合は最終検索語と理由をユーザー向け説明に残す
```
postgres
```
、
```
git
```
、
```
filesystem
```
のような広い技術語では、最初のノイジーな実行の後に
```
[term] mcp
```
や
```
[term] mcp server
```
のような precision pass を1回行い、その結果を最終の3ソース確認根拠として使う
途中の broad run が失敗、ノイズ過多、または根拠として使えない場合は、その実行を説明から切り離し、成功した最終 run だけを根拠として扱う
固有名詞の検索、または3ソース成功後も適合候補が見えない検索では、製品名やベンダー名で完全一致寄りの補助チェックを1回追加してよい。その確認は3ソース確認の一部ではなく、補助証拠として明示する
Registry と GitHub が空または無関係のままで、Smithery の残り候補も補助チェック後に対象名や必要機能へ結び付けられない場合は、弱い一致を無理に候補化せず no-fit と判定して代替案へ進む
Slack、GitHub、Supabase、Vercel など公式組織がありそうな対象で公式候補が見えない場合は、3ソース成功後でも一次情報による追加のベンダー確認を行う
製品名やベンダー名が曖昧な場合、補助確認は一般Web検索より先に公式ドメイン確認と GitHub 完全一致寄り検索を使う。一般Web検索は弱い補助証拠としてだけ扱う
候補名、ツール、スター数、更新日、導入方法などは取得済みの実データだけを使い、未確認項目は未確認と書く
hosted 候補に公開 repo や明確な repo provenance がない場合は、公式 docs などの一次情報で運営元と機能を確認できない限り、hosted または条件付き候補として扱う
必要な検索や確認が実行できない環境では、仮候補や仮比較表を出さず、未確認事項を報告して止まる

First, use the bundled CLI.

bash

node script/mcp-server-search.js github --limit 30

From the same JSON output, directly check at least the following:

```
sources.registry.ok
```
```
sources.smithery.ok
```
```
sources.github.ok
```
```
merged[]
```
```
normalized[]
```

Search Rules:

You can only state that all 3 sources have been confirmed if
```
sources.registry.ok
```
,
```
sources.smithery.ok
```
, and
```
sources.github.ok
```
are all
```
true
```
in the JSON from that execution
The basis for 3-source confirmation should only be the JSON from one execution of the bundled CLI that you ultimately adopt. If you re-run the search to narrow down results, only the final execution result can be cited as confirmed
Do not combine README checks, separate API executions, or GitHub searches and treat them as "3-source confirmed"
If any source is
```
false
```
or unconfirmed, explicitly state this fact and treat subsequent steps as supplementary research
If the search term is too broad, you can refine it while maintaining 3-source confirmation. In this case, leave the final search term and reason in the explanation for the user
For broad technical terms like
```
postgres
```
,
```
git
```
, or
```
filesystem
```
, after the initial noisy execution, perform one precision pass using
```
[term] mcp
```
or
```
[term] mcp server
```
, and use that result as the basis for final 3-source confirmation
If an intermediate broad run fails, has too much noise, or cannot be used as a basis, separate that execution from the explanation and only use the successful final run as the basis
For searches of proper nouns, or searches where no matching candidates are found even after successful 3-source confirmation, you may add one supplementary check focusing on exact matches of product names or vendor names. This confirmation is not part of 3-source confirmation and should be explicitly stated as supplementary evidence
If the Registry and GitHub are empty or irrelevant, and remaining Smithery candidates cannot be linked to the target name or required functions after supplementary checks, do not force weak matches into candidates; judge as no-fit and proceed to alternative solutions
For targets that likely have official organizations, such as Slack, GitHub, Supabase, Vercel, if no official candidates are found even after successful 3-source confirmation, perform additional vendor checks using primary sources
If product names or vendor names are ambiguous, use official domain checks and GitHub exact-match searches before general web searches for supplementary confirmation. General web searches should only be treated as weak supplementary evidence
Only use actual acquired data for candidate names, tools, star counts, update dates, installation methods, etc.; mark unconfirmed items as unconfirmed
For hosted candidates without a public repo or clear repo provenance, treat them as hosted or conditional candidates only if you can confirm the operator and functions through primary sources like official docs
In environments where necessary searches or confirmations cannot be executed, do not provide temporary candidates or comparison tables; report unconfirmed items and stop

3. 候補の優先順位付け

3. Candidate Prioritization

要件を満たす公式候補があるなら最優先にします。公式候補があるのに採用しない場合は、今回の要件に対して何が不足しているかを明示します。

公式判定では、少なくとも次を確認します。

GitHubリポジトリの owner が対象サービスの公式 organization または vendor と一致する
```
homepage
```
または
```
repositoryUrl
```
が公式ドメインか公式GitHub配下を指す
README、説明文、公開元情報、公式docs、公式ブログなどに一次情報がある

補足ルール:

Registry、Smithery、Registryの
```
official
```
や
```
featured
```
のようなメタデータだけで公式扱いしない
ベンダー公式docsが案内するホスト型MCP endpoint は公式候補として扱ってよいが、OSSリポジトリとは区別して説明する
```
postgres
```
や
```
git
```
のような汎用検索では、Neon や Supabase のようなサービス専用候補を別枠または条件付き候補として扱う

優先順位は

機能適合 > 安全性と保守性 > 人気度

人気度・普及度は GitHub
```
stargazers_count
```
、GitHub
```
updated_at
```
、Smithery
```
useCount
```
、Smithery
```
verified
```
、npm週次ダウンロード数で比較する

If there is an official candidate that meets requirements, prioritize it. If you do not adopt an official candidate, explicitly state what is lacking for the current requirements.

For official determination, confirm at least the following:

The owner of the GitHub repository matches the official organization or vendor of the target service
The
```
homepage
```
or
```
repositoryUrl
```
points to an official domain or official GitHub account
Primary information exists in the README, description, publisher information, official docs, official blog, etc.

Supplementary Rules:

Do not treat candidates as official based solely on metadata like Registry, Smithery, or Registry's
```
official
```
/
```
featured
```
tags
Hosted MCP endpoints guided by vendor official docs can be treated as official candidates, but should be described separately from OSS repositories
For general searches like
```
postgres
```
or
```
git
```
, treat service-specific candidates like Neon or Supabase as separate or conditional candidates

Prioritization order:

Functionality Fit > Security and Maintainability > Popularity

Popularity/adoption is compared using GitHub
```
stargazers_count
```
, GitHub
```
updated_at
```
, Smithery
```
useCount
```
, Smithery
```
verified
```
, and weekly npm download counts

4. 品質確認

4. Quality Confirmation

推奨前に、必要なTools/Resourcesがありそうか、保守状態が許容できるかを確認します。

READMEを確認するなら

https://raw.githubusercontent.com/.../README.md

を優先する

可能なら一時的に起動してTools/Resourcesを確認する
比較だけが目的、または read-only 評価なら、検証のためだけにインストールを強行せず、公開情報ベース比較と未実機確認であることを明示する

Before recommending, confirm if necessary Tools/Resources are available and if the maintenance status is acceptable.

If checking the README, prioritize

https://raw.githubusercontent.com/.../README.md

If possible, temporarily start the server to check Tools/Resources
If the goal is only comparison or read-only evaluation, do not force installation just for verification; explicitly state that the comparison is based on public information and no actual machine verification was performed

5. 候補提示と導入確認

5. Candidate Presentation and Installation Confirmation

インストール確認の前に、各候補について少なくとも次を示します。

MCPサーバー名
概要
検証で確認できた代表的なTools/Resourcesまたは機能カテゴリを3〜5個
導入方法。npmパッケージ、実行コマンド、HTTP URL のいずれか
人気度または普及度の指標
公式候補かどうか。非公式ならその理由

追加ルール:

同じ候補が複数ソースに出る場合は、repository URL、repo owner/name、install target、公式endpointなどで同一性を確認できたときだけ統合する
導入可能な候補があるなら、最初の候補提示でそのまま必要な導入確認まで進み、yes/no だけの往復を挟まない
```
vscode_askQuestions
```
ツールが使えるなら優先し、使えないなら通常のチャットで同じ項目を確認する
ユーザーがインストールしないなら、その時点で終了する

確認する項目:

候補が複数で未指定: どの候補を入れるか、プロジェクトかグローバルか、表示名
候補が1件または対象確定済み: プロジェクトかグローバルか、表示名

認証方式、transport、Docker可否、追加環境変数は、候補確定後でよいなら後回しにします。installコマンド確定に必須な場合だけ同時に聞きます。

Before installation confirmation, show at least the following for each candidate:

MCP server name
Overview
3 to 5 representative Tools/Resources or function categories confirmed during verification
Installation method: npm package, execution command, or HTTP URL
Popularity or adoption metrics
Whether it is an official candidate; if unofficial, state the reason

Additional Rules:

If the same candidate appears in multiple sources, only integrate it if identity can be confirmed via repository URL, repo owner/name, install target, official endpoint, etc.
If installable candidates exist, proceed directly to necessary installation confirmation in the first candidate presentation, without inserting yes/no back-and-forth
Prioritize using the
```
vscode_askQuestions
```
tool if available; if not, confirm the same items via regular chat
If the user chooses not to install, end the process at that point

Items to Confirm:

If multiple candidates are available and unspecified: Which candidate to install, project-level or global, display name
If only one candidate exists or the target is confirmed: Project-level or global, display name

Authentication methods, transport, Docker compatibility, and additional environment variables can be postponed if not necessary for confirming the install command. Only ask about them simultaneously if they are essential for finalizing the install command.

6. 導入とテスト

6. Installation and Testing

確定した導入対象に応じて追加します。

npmパッケージ:
```
npx add-mcp [npmパッケージ名]
```

引数付きstdioコマンド:

npx add-mcp "[実行コマンド 引数1 引数2 ...]"

HTTP URL:
```
npx add-mcp [HTTP URL]
```

add-mcp

で直接入れられない場合は、MCP用JSONの手動編集で対応できるかを確認し、編集前に許可を取り、無理ならカスタムMCPサーバー開発などの代替案を提示します。

スコープと表示名をコマンドへ反映します。例:

bash

npx add-mcp -a vscode -n my-github github-mcp-server
npx add-mcp -a vscode -g -n my-github github-mcp-server

導入後は必ず次を行います。

MCPサーバーを接続して起動する
必要な環境変数や認証情報を案内する
安全なread系またはping系ツールを実行する。認証必須のリモートMCPで
```
401 Unauthorized
```
が返る場合は、到達成功かつ認証未完了として扱う

npx add-mcp list -a vscode

と

npx add-mcp list -a vscode -g

の両方で導入確認する

テスト結果と利用可否を報告する

Add the confirmed target according to its type:

npm package:
```
npx add-mcp [npm package name]
```

stdio command with arguments:

npx add-mcp "[execution command argument1 argument2 ...]"

HTTP URL:
```
npx add-mcp [HTTP URL]
```

If installation via

add-mcp

is not possible, check if manual editing of MCP JSON is feasible, obtain permission before editing, and if not, present alternatives such as custom MCP server development.

Reflect the scope and display name in the command. Examples:

bash

npx add-mcp -a vscode -n my-github github-mcp-server
npx add-mcp -a vscode -g -n my-github github-mcp-server

After installation, be sure to do the following:

Connect and start the MCP server
Guide the user on necessary environment variables or authentication information
Execute a safe read-only or ping-type tool. For remote MCP servers requiring authentication that return
```
401 Unauthorized
```
, treat this as successful reachability with incomplete authentication

Confirm installation using both

npx add-mcp list -a vscode

and

npx add-mcp list -a vscode -g

Report test results and usability

検索ヒント

Search Tips

カテゴリ	検索語例	よくある用途
データベース	`postgres` , `sqlite` , `mysql`	クエリ、集計、書き込み
開発ツール	`github` , `gitlab` , `git`	コード検索、PR、Issue
コミュニケーション	`slack` , `discord`	メッセージ、チャンネル
ファイル・OS	`filesystem` , `bash` , `cli`	ローカルファイル、コマンド実行
情報検索	`brave` , `google` , `wikipedia`	Web検索、最新情報

Category	Search Term Examples	Common Use Cases
Database	`postgres` , `sqlite` , `mysql`	Querying, aggregation, writing
Development Tools	`github` , `gitlab` , `git`	Code search, PRs, Issues
Communication	`slack` , `discord`	Messaging, channels
Files & OS	`filesystem` , `bash` , `cli`	Local files, command execution
Information Search	`brave` , `google` , `wikipedia`	Web search, latest information

候補が見つからない場合

When No Candidates Are Found

既存のMCPサーバーでは要件を満たせないことを伝える
エージェント標準機能などの代替案を提案する
Python または TypeScript でのカスタムMCPサーバー開発支援を提案する

Inform the user that existing MCP servers cannot meet the requirements
Propose alternatives such as agent standard functions
Propose support for custom MCP server development in Python or TypeScript