mcp-builder
Claude Code向けMCPサーバーの構築
こちらからも入手できます: AutumnsGrove,ComposioHQ,92Bilal26,YYH211,anthropics,ZhanlinCui,davila7,Doyajin174,DYAI2025,92Bilal26,mcp-use,ArtemisAI,Azeem-2,Cam10001110101
このスキルは、Claude CodeとCodexが適切に設計されたツールを通じて外部APIと対話できるようにするModel Context Protocolサーバーを構築するための包括的なガイダンスを提供します。TypeScriptとPythonの実装例、ベストプラクティス、評価戦略をカバーしています。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「mcp-builder」を使用しています。 TypeScriptで基本的なMCPサーバープロジェクトをセットアップするにはどうすればいいですか？
期待される結果:
TypeScriptで基本的なMCPサーバープロジェクトをセットアップするには：
1. 新しいNode.jsプロジェクトを初期化：npm init -y
2. MCP TypeScript SDKをインストール：npm install @modelcontextprotocol/server-sdk
3. 入力検証にZodを使用したツール定義でサーバーファイルを作成
4. サーバーにツールを登録し、トランスポート（stdioまたはStreamable HTTP）を定義
5. 選択したトランスポートで使用するためにサーバーをエクスポート
このスキルは各ステップの完全な例とコードスニペットを提供します。
「mcp-builder」を使用しています。 MCPサーバーのツール命名に関するベストプラクティスは何ですか？
期待される結果:
MCPツール命名のベストプラクティス：
- 一貫性のあるプレフィックスを使用（例：github_create_issue、github_list_repos）
- ツールの動作を説明するアクション指向の名前を使用
- 統合されるサービスの説明的な名前を使用
- 名前にバージョン番号を避ける
- エージェントが正しいツールを素早く見つけるのを助ける明確で曖昧のない名前を使用
「mcp-builder」を使用しています。 MCPサーバーのエラーメッセージはどのように構造化すべきですか？
期待される結果:
エラーメッセージは実行可能で、エージェントを解決策に導く必要があります：
- エラーを修正するための具体的な提案を含める
- エージェントが取れる次のステップを提供
- 標準のJSON-RPCエラーコードを使用
- エラーメッセージは、LLMが何が問題だったかを理解して回復する方法を知るのに十分な説明的にする
セキュリティ監査
安全This skill is a documentation and guide resource for building MCP servers. The static scanner detected patterns (network calls, environment variable access, shell commands) in reference documentation files containing code examples. These are all false positives - the skill contains no executable code, only markdown documentation with example code snippets demonstrating standard API integration patterns.
リスク要因
⚡ スクリプトを含む
🌐 ネットワークアクセス
📁 ファイルシステムへのアクセス
🔑 環境変数
⚙️ 外部コマンド
品質スコア
作れるもの
カスタムAPI用の新しいMCPサーバーを構築
開発者がClaude Codeに会社の内部APIを統合するためのMCPサーバーを作成したいと考えています。ステップバイステップガイドに従って、MCPサーバーの計画、実装、テストを行います。
MCPプロトコルのベストプラクティスを学ぶ
技術ライターやプロダクトマネージャーが、MCPサーバーの仕組みと、LLM統合に有効な特徴を理解したいと考えています。
既存のMCPサーバー品質を評価
AIエンジニアがMCPサーバーの実装を評価し、LLMが提供されたツールを効果的に使用できるようにしたいと考えています。
これらのプロンプトを試す
TypeScript SDKを使用して基本的なMCPサーバーを作成する手助けをしてください。作成、読み取り、更新、削除のツールを持つシンプルなAPI（Todoリストなど）を公開したいと考えています。プロジェクト構造とコア実装を示してください。
MCPサーバーにAPIキー認証を追加するにはどうすればいいですか？環境変数からAPIキーを読み取り、外部サービスへのリクエストに含める必要があります。
MCPサーバーツールの説明を確認し、改善を提案してください。Claude Codeが各ツールの目的を理解し、効果的に使用できるようにしたいと考えています。以下は現在のツール定義です：[ツール定義を追加]
MCPサーバーの評価フレームワークを作成する手助けをしてください。Claude Codeが私のツールを使用してAPIに関する現実的な質問に効果的に答えられるかどうかをテストしたいです。
ベストプラクティス
- エージェントに柔軟性を与えるために、高レベルなワークフローツールよりも包括的なAPIカバレッジを優先
- タイトル、説明、inputSchema、アノテーションを含む明示的なツール定義を使用
- 実行時型安全のためにZod（TypeScript）またはPydantic（Python）で入力検証を設計
- LLMがツールを効果的に使用できることを確認するために、評価フレームワークでMCPサーバーをテスト
回避
- 実行されるアクションを明確に説明しない曖昧なツール名は避ける
- 入力検証をスキップしない - 常に適切なスキーマでユーザー入力を検証
- ツールから過度に冗長またはフィルタリングされていないデータを返さない - 集中したレスポンスを設計
- 一般的なエラーメッセージを使用しない - 回復のための実行可能なガイダンスを提供