MCP Handson Bf183066

MCP运维云端

提供方 MasaoAsano · 包名 tsc

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

Model Context Protocol (MCP) 是一个标准化协议,使AI助手能够与外部工具和数据源进行交互。本教程通过实践学习MCP的基本概念、架构和实现方法。

一句话选型结论

按资料字段整理

MCP Handson Bf183066 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI交互协议TypeScript本地部署标准化协议工具集成数据源交互开发教程

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx tsc --noEmit # 型チェックのみ実行

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Handson Bf183066当前 8 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方MasaoAsano上游标注的维护方 MasaoAsano
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时tsc · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.2 KB
来自项目仓库与上游目录的原文,未做删改

MCP ハンズオン教材

概要

この教材では、Model Context Protocol (MCP) について実際に手を動かしながら学びます。MCPは、AIアシスタントが外部ツールやデータソースと標準化された方法で対話できるようにするためのプロトコルです。

学習目標

このハンズオンを通じて、以下のスキルを習得できます:

  • 従来のREST APIとMCPの違いを体感
  • MCPの基本概念とアーキテクチャの理解
  • MCPサーバーの実装方法
  • MCPクライアントとの接続方法
  • リソース、ツール、プロンプトの実装
  • 実践的なMCPアプリケーションの開発

前提知識

  • JavaScript/TypeScript の基本的な知識
  • Node.js の基本的な使い方
  • コマンドライン の基本操作
  • JSON の基本的な理解

MCPの基本的な構成要素:
- サーバー(Server): 機能を提供する側
- クライアント(Client): 機能を利用する側
- リソース(Resources): 読み取り専用のデータ
- ツール(Tools): 実行可能な操作
- プロンプト(Prompts): LLM用のテンプレート

環境セットアップ

必要なツール```bash

Node.js (v18以上推奨)

node --version

npmの確認

npm --version


### プロジェクトのセットアップ```bash
# リポジトリをクローン
git clone https://github.com/MasaoAsano/mcp-handson.git
cd mcp-handson

# 依存パッケージをインストール
npm install

これで準備完了です!

クイックスタート```bash

第1章: 従来のAPIとMCPを比較してみる

npm run ch01:mcp

第2章: Hello Worldサーバーを起動

npm run ch02:hello

第6章: タスク管理システムを使ってみる

npm run ch06:client


---

## ハンズオンの構成

### 第1章: 従来のAPIとMCPの比較 ⭐

**所要時間: 30分**

同じタスク管理機能を、従来のREST APIとMCPの両方で実装し、違いを明確に理解します。

**学習内容:**
- REST APIの実装(Express.js)
- MCPでの同等実装
- 両者の設計思想の違い
- MCPの利点(自己記述性、AI統合)

**含まれるファイル:**
- `traditional-api/server.ts` - REST APIサーバー
- `traditional-api/client.ts` - fetchを使ったクライアント
- `mcp-approach/server.ts` - MCPサーバー
- `mcp-approach/client.ts` - MCPクライアント
- `comparison.md` - 詳細な比較ドキュメント

**実行方法:**```bash
npm run ch01:traditional  # REST API版
npm run ch01:mcp          # MCP版

第2章: 最初のMCPサーバー

所要時間: 40分

MCPサーバーの基本構造を理解し、リソースを提供する方法を学びます。

2.1 Hello Worldサーバー

最もシンプルなMCPサーバーを作成します。

サンプル: samples/01-hello-server.ts
- サーバーの基本構造
- 1つのリソースの提供
- リクエストハンドラーの設定

演習1: 自分の名前を返すサーバーを作成
- exercises/exercise-01.md - 演習ガイド
- exercises/exercise-01-template.ts - テンプレート

2.2 複数リソースの提供

動的なURIと複数リソースの扱い方を学びます。

サンプル: samples/02-server-with-resources.ts
- 複数リソースの定義
- 動的なURI(例: books://item/{id})
- パターンマッチング

演習2: 好きな映画/アニメのカタログサーバーを作成
- exercises/exercise-02.md - 演習ガイド
- exercises/exercise-02-template.ts - テンプレート

実行方法:```bash
npm run ch02:hello # Hello Worldサーバー
npm run ch02:resources # 書籍ライブラリサーバー


---

### 第3章: ツールの実装

**所要時間: 50分**

状態を変更する操作(ツール)の実装方法を学びます。

**3.1 基本的なツール**

**サンプル:** `samples/calculator-tool.ts`
- 四則演算ツール(add, subtract, multiply, divide)
- 入力スキーマの定義
- パラメータの検証
- エラーハンドリング

**3.2 複数ツールの統合**

**サンプル:** `samples/weather-tool.ts` と `samples/server-with-tools.ts`
- 天気情報取得ツール(モックデータ)
- 複数ツールの統合サーバー
- ツール間の連携

**演習:** 文字列操作ツールを作成
- `exercises/exercise-01.md` - 演習ガイド
- `exercises/exercise-01-template.ts` - テンプレート
- uppercase, lowercase, reverse の3つのツール

**実行方法:**```bash
npm run ch03:calculator  # 統合ツールサーバー

第4章: プロンプトの実装

所要時間: 35分

LLM用の再利用可能なプロンプトテンプレートを作成します。

4.1 動的プロンプト

サンプル: samples/prompt-templates.ts
- メール作成プロンプト(tone, recipient, subject対応)
- コードレビュープロンプト(language, focus対応)
- 記事要約プロンプト(length対応)
- 引数を使った動的生成

4.2 リソース・ツール・プロンプトの統合

サンプル: samples/server-with-prompts.ts
- すべての機能を持つサーバー
- 統合的な使用例

実行方法:```bash
npm run ch04:prompts # プロンプトサーバー


---

### 第5章: クライアントの実装

**所要時間: 40分**

MCPサーバーと通信するクライアントを実装します。

**5.1 基本的なクライアント**

**サンプル:** `samples/basic-client.ts`
- クライアントの初期化
- サーバーへの接続
- ツールの呼び出し
- リソースの読み取り

**5.2 高度なクライアント**

**サンプル:** `samples/client-with-tools.ts`
- バッチ処理
- エラーハンドリング
- 複数の操作を連続実行

**実行方法:**```bash
npm run ch05:client  # クライアントデモ

第6章: 実践プロジェクト - タスク管理システム 🎯

所要時間: 90分

これまで学んだすべての要素を統合した、実用的なタスク管理システムを構築します。

システム構成:

データ層: samples/task-manager/types.ts + storage.ts
- Task型の定義
- JSONファイルベースのストレージ
- CRUD操作
- 検索機能

サーバー層: samples/task-manager/server.ts

リソース:
- tasks://all - 全タスクのリスト
- tasks://summary - 統計情報
- tasks://item/{id} - 個別タスク

ツール:
- create_task - タスク作成
- update_task - タスク更新
- delete_task - タスク削除
- search_tasks - 検索

プロンプト:
- create_task_prompt - タスク作成支援
- weekly_report - 週次レポート生成

クライアント: samples/task-manager/client.ts
- デモ用クライアント
- 全機能の使用例

機能:
- ✅ タスクの作成、更新、削除
- ✅ ステータス管理(todo, in-progress, done)
- ✅ 優先度設定(low, medium, high)
- ✅ タグ機能
- ✅ 検索とフィルタリング
- ✅ 統計情報の表示

実行方法:```bash
npm run ch06:server # サーバー起動
npm run ch06:client # クライアントデモ


---

### 第7章: テストとデバッグ

**所要時間: 30分**

MCPアプリケーションのテストとデバッグ手法を学びます。

**7.1 ユニットテスト**

**サンプル:** `samples/tools.test.ts`
- Jestを使ったテスト
- ツールのテスト例
- テストの書き方

**実行方法:**```bash
npm test  # テスト実行

7.2 デバッグのベストプラクティス

  • console.errorを使ったログ出力
  • エラーメッセージの設計
  • トラブルシューティング

発展課題(時間があれば):
- セキュリティ: 入力検証の強化
- パフォーマンス: キャッシング戦略
- Claude Desktopとの統合


ディレクトリ構成```

mcp-handson/
├── readme.md # このファイル
├── package.json # プロジェクト設定
├── tsconfig.json # TypeScript設定
├── jest.config.js # Jestテスト設定
├── .gitignore
│
├── chapter-01/ # 第1章: API比較
│ ├── traditional-api/
│ │ ├── server.ts # REST APIサーバー
│ │ └── client.ts # REST APIクライアント
│ ├── mcp-approach/
│ │ ├── server.ts # MCPサーバー
│ │ └── client.ts # MCPクライアント
│ └── comparison.md # 比較ドキュメント
│
├── chapter-02/ # 第2章: 最初のサーバー
│ ├── samples/
│ │ ├── 01-hello-server.ts # Hello World
│ │ └── 02-server-with-resources.ts # リソース付き
│ └── exercises/
│ ├── exercise-01.md # 演習ガイド
│ ├── exercise-01-template.ts # テンプレート
│ ├── exercise-02.md
│ └── exercise-02-template.ts
│
├── chapter-03/ # 第3章: ツール
│ ├── samples/
│ │ ├── calculator-tool.ts # 計算機
│ │ ├── weather-tool.ts # 天気情報
│ │ └── server-with-tools.ts # 統合サーバー
│ └── exercises/
│ ├── exercise-01.md # 文字列操作演習
│ └── exercise-01-template.ts
│
├── chapter-04/ # 第4章: プロンプト
│ └── samples/
│ ├── prompt-templates.ts # テンプレート集
│ └── server-with-prompts.ts # 統合サーバー
│
├── chapter-05/ # 第5章: クライアント
│ └── samples/
│ ├── basic-client.ts # 基本クライアント
│ └── client-with-tools.ts # 高度な使用例
│
├── chapter-06/ # 第6章: 実践プロジェクト
│ └── samples/
│ └── task-manager/
│ ├── types.ts # 型定義
│ ├── storage.ts # データ永続化
│ ├── server.ts # タスク管理サーバー
│ └── client.ts # クライアント
│
└── chapter-07/ # 第7章: テスト
└── samples/
└── tools.test.ts # テスト例


## 各章の実行コマンド```bash
# 第1章: API比較
npm run ch01:traditional    # 従来のREST API
npm run ch01:mcp            # MCPアプローチ

# 第2章: 最初のサーバー
npm run ch02:hello          # Hello Worldサーバー
npm run ch02:resources      # リソース付きサーバー

# 第3章: ツール
npm run ch03:calculator     # 計算機 & 天気ツール

# 第4章: プロンプト
npm run ch04:prompts        # プロンプトテンプレート

# 第5章: クライアント
npm run ch05:client         # MCPクライアントデモ

# 第6章: 実践プロジェクト
npm run ch06:server         # タスク管理サーバー
npm run ch06:client         # タスク管理クライアント

# 第7章: テスト
npm test                    # 全テスト実行

学習の進め方

推奨学習パス

  1. 第1章 - MCPの違いを体感(30分)
  2. 第2章 - サーバーの基礎を習得(40分)
  3. 第3章 - ツールの実装を学ぶ(50分)
  4. 第4章 - プロンプトを理解(35分)
  5. 第5章 - クライアントを作成(40分)
  6. 第6章 - 実践プロジェクトに挑戦(90分)
  7. 第7章 - テストとデバッグ(30分)

合計所要時間: 約5時間15分

学習のコツ

✅ 必ずサンプルを実行する: 読むだけでなく、実際に動かしてみましょう
✅ 演習に取り組む: 手を動かすことで理解が深まります
✅ 段階的に進める: 焦らず、1章ずつ確実に理解しましょう
✅ エラーを恐れない: エラーは学習の機会です

参考リソース

公式ドキュメント

  • MCP 公式ドキュメント
  • MCP TypeScript SDK
  • MCP 仕様

サンプルコード

  • 公式サンプルサーバー集
  • このハンズオンのサンプルコード(各章ごとに提供)

コミュニティ

  • MCP Discord サーバー
  • GitHub Discussions

トラブルシューティング

よくある問題と解決方法

1. パッケージのインストールエラー```bash

npm install @modelcontextprotocol/sdk
npm install -D @types/node typescript


#### 2. サーバーが起動しない

- Node.js のバージョンを確認(v18以上推奨)
- `node --version`

#### 3. TypeScriptのエラー```bash
npx tsc --noEmit  # 型チェックのみ実行

4. クライアントが接続できない

  • サーバーが正常に起動しているか確認
  • ファイルパスが正しいか確認

次のステップ

このハンズオンを完了したら、以下に挑戦してみましょう:

🚀 より複雑なツールの実装
- ファイル操作ツール
- データベース連携ツール

🚀 実際のAIアシスタントとの統合
- Claude Desktopへの組み込み
- 設定ファイルの作成

🚀 プロダクション環境へのデプロイ
- セキュリティの強化
- パフォーマンスの最適化

🚀 コミュニティへの貢献
- 自作サーバーの公開
- ドキュメントの改善

ライセンス

このハンズオン教材は MIT ライセンスの下で提供されています。

フィードバック

この教材に関するフィードバックや改善提案は、GitHubのIssuesまでお願いします。


それでは、MCPの世界へようこそ!

第1章から順に進めて、実際に手を動かしながらMCPの理解を深めていきましょう。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Handson Bf183066 怎么安装?

在客户端按下面的安装命令接入:npx tsc --noEmit # 型チェックのみ実行。对应的包名是 tsc。装完在客户端配置里引用同一个包或端点。

MCP Handson Bf183066 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Handson Bf183066 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Handson Bf183066 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Handson Bf183066 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Handson Bf183066 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 标准化协议、TypeScript、Claude。具体工具清单以官方文档为准。

MCP Handson Bf183066 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Handson Bf183066 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。