Claud MCP の編集

# 目次
[TOC]

# Claude MCPの入門ブログ
Claude MCP（Model-Context-Protocol）とは、MCPサーバを経由して外部のリソースをClaudeが使えるようになる仕組みのことである。

MCPサーバは外部のリソースに応じた、かなりたくさんの種類が開発されている。

外部リソースには、自分のPCのファイルなども含まれているので、チャット履歴を自分のPCに保存することも可能になってくる。

# anthoropicの公式
## Introducing the Model Context Protocol

https://www.anthropic.com/news/model-context-protocol

## Get Started (大事！でもないか、わかりづらい)
開発に必須の内容が詰まっている。網羅されているのはよいが、わかりづらい。MCPサーバを１ファイルの部分ごとに意味を説明しながら作らせる感じなので、どこかで躓くとデバッグが困難だ。デバッグの説明のドキュメントはMacを使う前提っぽい説明なのだ。ちょっと最初の入門としては敷居が高そうな印象だ。というわけで、最初のおすすめチュートリアルとしては、すでにできたMCPサーバを後述のMCPサーバをGithubからダウンロードするほうがとっつきやすいと思う。

https://modelcontextprotocol.io/introduction

- ドキュメント
- SDK
- チュートリアル

# クイックスタート
原文:

https://modelcontextprotocol.io/quickstart

最初のMCPサーバーを構築し、ホストに接続してみましょう

このチュートリアルでは、シンプルな MCP 天気予報サーバーを構築し、ホストである Claude for Desktop に接続します。まずは基本的なセットアップから始めて、より複雑なユースケースに進みます。

## Claude for Desktopβ版ダウンロード
https://claude.ai/download

サーバのロードに失敗したらfileメニューから終了しないと、リセットされてないっぽい

チュートリアルで、MCPサーバのサンプルが作れるのだが、それは、Claude for Desktopをつかうので、ダウンロードして設定が必要

チュートリアルでの難しい所は、Claude for Desktop起動時に、MCPサーバを定義に従って接続しに行くのだが、設定がずれるとエラーになる。しかしエラーログの出し方がわかりにくいためはまってしまって、解決策は不明のまま先に進めない。

なので、あらかじめある程度そろったコードで試すよりほかない。

# MCPサーバの宝庫
ここが真のチュートリアルであり、よく使うMCPサーバ置き場なのではなかろうか。という認識である。

https://smithery.ai/

↑ダウンロード数のようなものがでているので、人気なMCPがわかるので、おすすめでいいやっていう人にはいいかも

https://github.com/punkpeye/awesome-mcp-servers

https://github.com/modelcontextprotocol/servers

https://mcp-get.com/

このリポジトリのようなAIの外部拡張は、OS標準装備にするべき、もしくは、AI時代となる現代の義務教育に取り込むべきレベルと言っても過言ではない気がする。空気のように扱えるようにすべきか。。。。

ただしAIがやろうとしていることが正しいわけではないので、ロールバックができたりする状況が必要だったり、確認のインタフェースが必要だったりすると思う。

失敗を戻せる環境つまり、MCPのgitは必須になってくる。

# 導入手順
## 作成済みのMCPサーバを手に入れる

https://github.com/punkpeye/awesome-mcp-servers

## git cloneする
    git clone https://github.com/punkpeye/awesome-mcp-servers.git

ここにはサーバのコードが入っていない。つまりリンク集のようだ

以下をgit cloneしましょう、いくつかサーバがまとまっている

https://github.com/modelcontextprotocol/servers

サーバがまとまっているのは上記だけでは無いようだ

https://glama.ai/mcp/servers?attributes=

## 本家以外にもチュートリアルの記事がたくさんある
https://glama.ai/blog/2024-11-25-model-context-protocol-quickstart

https://reffect.co.jp/ai/claude-mcp

# 気になるMCPサーバ
たくさんあるので、使いそうなものがある

## ローカルサーバ用MCP
たくさんあるが、基本はローカルファイルアクセスだと思う

@modelcontextprotocol/server-filesystem

### claude_desktop_config.jsonのWindowsでの設定、動作確認済み

{
       "mcpServers": {
         "filesystem": {
           "command": "npx",
           "args": [
             "-y",
             "@modelcontextprotocol/server-filesystem",
             "C:/Users/kh/Desktop",
             "C:/Users/kh/prj/mcp_tutorial"
           ]
         }
       }
     }

許可しているディレクトリをどんどん追加していける

### ほかの人が設定したブログ
https://note.com/k1mu/n/n7ab09ac7b4e3

## 検索エンジン brave-search
検索エンジンといえばGoogleだが、検索履歴が残る、AIが検索する履歴は利用者の好みとはまた別である。そこでbrave-searchという、検索履歴を残さない検索エンジンを使う

https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search

### APIキーの取得方法
- 1. [Brave Search APIアカウント](https://brave.com/search/api/)に登録
- 2. プランを選択（無料枠は月2,000クエリまで利用可能）
- 3. [開発者ダッシュボード](https://api.search.brave.com/app/keys)からAPIキーを生成

### Claude Desktopでの使用方法
`claude_desktop_config.json`に以下を追加してください：

```json
{
     "mcpServers": {
       "brave-search": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-brave-search"
         ],
         "env": {
           "BRAVE_API_KEY": "ここにあなたのAPIキーを入力"
         }
       }
     }
}
```

### 使ってみた感想
うーん、検索の精度はあまり高くないかな。今後に期待。

## ローカルのgitを見つめなおすMCPサーバ
コミットコメントとか代筆してくれるかも
@modelcontextprotocol/server-git

## github用のMCPサーバ
レビューを行うAIになりうるかもしれません
@modelcontextprotocol/server-github

## obsidian用のMCPサーバ
Youtubeでおすすめされていた
MarkusPfundstein/mcp-obsidian

## MCPサーバを管理するUI用のMCPサーバ
サーバじゃないのか？
zueai/mcp-manager

## 家電を制御できるMCPサーバだと！？
tevonsb/homeassistant-mcp

## google Calendar
https://github.com/markelaugust74/mcp-google-calendar

https://github.com/MarkusPfundstein/mcp-gsuite

## 長期記憶ができるだと？
https://qiita.com/Maki-HamarukiLab/items/3ccf9cd6edd634476d02

## curlライクなMCPサーバ
https://github.com/mcp-get/community-servers/tree/main/src/server-curl

## Javaでもつかえるのかな？
https://spring.io/blog/2024/12/11/spring-ai-mcp-announcement

https://github.com/spring-projects-experimental/spring-ai-mcp

### Java MCPサーバの実装例
https://github.com/spring-projects/spring-ai-examples/tree/main/model-context-protocol

## すでにMCPサーバを作るためのフレームワーク化が進行しているみたいだ
https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#frameworks

## APIがつかえたら、どこにでも接続できるのでは？

### snaggle-ai/openapi-mcp-server
https://github.com/snaggle-ai/openapi-mcp-server

# MCPを定義する項目の説明

## 役割:
モデルやエージェントの役割を明確に定義します。例えば、「アシスタント」、「エージェント」、「エキスパート」などです。

## アクション:
モデルが実行できるアクションを定義します。例えば、「情報を検索する」、「要約を作成する」、「コードを生成する」などです。

## コンテキスト:
モデルがアクセスできる関連情報を定義します。例えば、ドキュメント、過去の会話履歴、外部データなどです。

## コントローラー:
モデルの動作を制御するための命令とパラメータを定義します。例えば、応答の長さ、フォーマット、スタイルなどです。

# アーキテクチャ
以下の記事をまとめる

https://modelcontextprotocol.io/docs/concepts/architecture

MCPは、MCPサーバと、MCPクライアントの通信から成り立つ。
MCPサーバとMCPクライアントは1:1で通信を行う。
MCPクライアントをホスト（ClaudeアプリやIDE）では複数持つことができる

# プロトコル
チュートリアルをまだやっていないならば、これはまだ見ないほうがいい。
Pythonの例やTypeScriptの例が記載されていた。いきなりこれを見ても、なにかわからない。チュートリアルを先にやらないとわからない気がする。

class Protocol<Request, Notification, Result> {
        // 受信したリクエストを処理する
        setRequestHandler<T>(schema: T, handler: (request: T, extra: RequestHandlerExtra) => Promise<Result>): void
    
        // 受信した通知を処理する
        setNotificationHandler<T>(schema: T, handler: (notification: T) => Promise<void>): void
    
        // リクエストを送信し、レスポンスを待機する
        request<T>(request: Request, schema: T, options?: RequestOptions): Promise<T>
    
        // 一方向の通知を送信する
        notification(notification: Notification): Promise<void>
    }

# トランスポート
やり方が２つあって、１つは、標準入出力を使う方法、もう一つはSSEというネットワークを使う方法である。メッセージの形式は、JSON-RPC 2.0 を使用してメッセージを交換する。

# おすすめMCP
## context7
LLMは、使用するライブラリに関する古い情報や一般的な情報に依存しています。なので、コード生成すると出てくるライブラリのバージョンが古かったりするので、このMCPを入れると新しいバージョンのライブラリを提案してくれるようになる。

また、ハルシネーションで、存在しないライブラリを提案しないようにしてくれる。

https://github.com/upstash/context7

### context7紹介サイト
https://www.ey-office.com/blog_archive/2025/05/20/if-you-want-ai-to-write-code-for-you-context7-mcp-is-a-must/

## DeepWikiのMCP
https://github.com/regenrek/deepwiki-mcp

関連するサイトをまとめたドキュメントを作成することができる

## sequentialthinking
ステップを踏んで、考えてくれるようになる

https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking

# MCP紹介サイト
https://qiita.com/masakinihirota/items/8971aa8ccead3193e77f

SPAMではありませんタイムスタンプを変更しない

# 目次
[TOC]

# Claude MCPの入門ブログ
Claude MCP（Model-Context-Protocol）とは、MCPサーバを経由して外部のリソースをClaudeが使えるようになる仕組みのことである。

MCPサーバは外部のリソースに応じた、かなりたくさんの種類が開発されている。

外部リソースには、自分のPCのファイルなども含まれているので、チャット履歴を自分のPCに保存することも可能になってくる。

# anthoropicの公式
## Introducing the Model Context Protocol

https://www.anthropic.com/news/model-context-protocol

https://modelcontextprotocol.io/introduction

- ドキュメント
- SDK
- チュートリアル

# クイックスタート
原文:

https://modelcontextprotocol.io/quickstart

最初のMCPサーバーを構築し、ホストに接続してみましょう

## Claude for Desktopβ版ダウンロード
https://claude.ai/download

サーバのロードに失敗したらfileメニューから終了しないと、リセットされてないっぽい

チュートリアルで、MCPサーバのサンプルが作れるのだが、それは、Claude for Desktopをつかうので、ダウンロードして設定が必要

なので、あらかじめある程度そろったコードで試すよりほかない。

# MCPサーバの宝庫
ここが真のチュートリアルであり、よく使うMCPサーバ置き場なのではなかろうか。という認識である。

https://smithery.ai/

↑ダウンロード数のようなものがでているので、人気なMCPがわかるので、おすすめでいいやっていう人にはいいかも

https://github.com/punkpeye/awesome-mcp-servers

https://github.com/modelcontextprotocol/servers

https://mcp-get.com/

失敗を戻せる環境つまり、MCPのgitは必須になってくる。

# 導入手順
## 作成済みのMCPサーバを手に入れる

https://github.com/punkpeye/awesome-mcp-servers

## git cloneする
    git clone https://github.com/punkpeye/awesome-mcp-servers.git

ここにはサーバのコードが入っていない。つまりリンク集のようだ

以下をgit cloneしましょう、いくつかサーバがまとまっている

https://github.com/modelcontextprotocol/servers

サーバがまとまっているのは上記だけでは無いようだ

https://glama.ai/mcp/servers?attributes=

## 本家以外にもチュートリアルの記事がたくさんある
https://glama.ai/blog/2024-11-25-model-context-protocol-quickstart

https://reffect.co.jp/ai/claude-mcp

# 気になるMCPサーバ
たくさんあるので、使いそうなものがある

## ローカルサーバ用MCP
たくさんあるが、基本はローカルファイルアクセスだと思う

@modelcontextprotocol/server-filesystem

### claude_desktop_config.jsonのWindowsでの設定、動作確認済み

許可しているディレクトリをどんどん追加していける

### ほかの人が設定したブログ
https://note.com/k1mu/n/n7ab09ac7b4e3

https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search

### Claude Desktopでの使用方法
`claude_desktop_config.json`に以下を追加してください：

### 使ってみた感想
うーん、検索の精度はあまり高くないかな。今後に期待。

## ローカルのgitを見つめなおすMCPサーバ
コミットコメントとか代筆してくれるかも
@modelcontextprotocol/server-git

## github用のMCPサーバ
レビューを行うAIになりうるかもしれません
@modelcontextprotocol/server-github

## obsidian用のMCPサーバ
Youtubeでおすすめされていた
MarkusPfundstein/mcp-obsidian

## MCPサーバを管理するUI用のMCPサーバ
サーバじゃないのか？
zueai/mcp-manager

## 家電を制御できるMCPサーバだと！？
tevonsb/homeassistant-mcp

## google Calendar
https://github.com/markelaugust74/mcp-google-calendar

https://github.com/MarkusPfundstein/mcp-gsuite

## 長期記憶ができるだと？
https://qiita.com/Maki-HamarukiLab/items/3ccf9cd6edd634476d02

## curlライクなMCPサーバ
https://github.com/mcp-get/community-servers/tree/main/src/server-curl

## Javaでもつかえるのかな？
https://spring.io/blog/2024/12/11/spring-ai-mcp-announcement

https://github.com/spring-projects-experimental/spring-ai-mcp

### Java MCPサーバの実装例
https://github.com/spring-projects/spring-ai-examples/tree/main/model-context-protocol

## すでにMCPサーバを作るためのフレームワーク化が進行しているみたいだ
https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#frameworks

## APIがつかえたら、どこにでも接続できるのでは？

### snaggle-ai/openapi-mcp-server
https://github.com/snaggle-ai/openapi-mcp-server

# MCPを定義する項目の説明

## 役割:
モデルやエージェントの役割を明確に定義します。例えば、「アシスタント」、「エージェント」、「エキスパート」などです。

## アクション:
モデルが実行できるアクションを定義します。例えば、「情報を検索する」、「要約を作成する」、「コードを生成する」などです。

## コンテキスト:
モデルがアクセスできる関連情報を定義します。例えば、ドキュメント、過去の会話履歴、外部データなどです。

## コントローラー:
モデルの動作を制御するための命令とパラメータを定義します。例えば、応答の長さ、フォーマット、スタイルなどです。

# アーキテクチャ
以下の記事をまとめる

https://modelcontextprotocol.io/docs/concepts/architecture

また、ハルシネーションで、存在しないライブラリを提案しないようにしてくれる。

https://github.com/upstash/context7

### context7紹介サイト
https://www.ey-office.com/blog_archive/2025/05/20/if-you-want-ai-to-write-code-for-you-context7-mcp-is-a-must/

## DeepWikiのMCP
https://github.com/regenrek/deepwiki-mcp

関連するサイトをまとめたドキュメントを作成することができる

## sequentialthinking
ステップを踏んで、考えてくれるようになる

https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking

# MCP紹介サイト
https://qiita.com/masakinihirota/items/8971aa8ccead3193e77f

テキスト整形のルールを表示する