MCP (Model Context Protocol)

[ Claude / IDE ]  <----- MCP -----> [ MCP Server ]
                                      ├ Tools (関数)
                                      ├ Resources (ファイル等)
                                      └ Prompts (テンプレ)

claude mcp add github stdio "npx @modelcontextprotocol/server-github"

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
    }
  }
}

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def echo(text: str) -> str:
    '''与えられた文字列をそのまま返す'''
    return text

if __name__ == "__main__":
    mcp.run()

claude mcp add github stdio "npx -y @modelcontextprotocol/server-github" -e GITHUB_TOKEN=ghp_xxx

> https://github.com/anthropics/anthropic-sdk-python の最新 5 PR を要約して
> issue #42 にコメントして「LGTM、approve しました」と書いて
> このリポジトリの直近 10 コミットを著者別に集計

claude mcp add fs stdio "npx -y @modelcontextprotocol/server-filesystem ~/Documents/specs ~/Documents/notes"

> ~/Documents/specs/api-spec-v2.md を読んで、これに沿って実装して
> ~/Documents/notes 配下の設計メモから、認証関連だけ抽出して要約

claude mcp add notion stdio "npx -y @notionhq/notion-mcp-server" -e NOTION_API_KEY=secret_xxx

> Notion の「設計レビュー 2026Q1」ページを読んで、未決議事項を Issue として GitHub に起票して

claude mcp add slack stdio "npx -y @modelcontextprotocol/server-slack" -e SLACK_BOT_TOKEN=xoxb-xxx -e SLACK_TEAM_ID=Txxx

> #general の最新 50 メッセージから、未対応の質問を抽出してリストにして
> #ops に「本日のデプロイ完了しました 🚀」と投稿

claude mcp add pg stdio "npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost:5432/mydb"

> users テーブルから直近 7 日のサインアップ数を日別に集計して
> orders テーブルのスキーマを確認し、何かおかしい箇所があれば指摘

CREATE USER claude_readonly WITH PASSWORD 'xxx';
GRANT CONNECT ON DATABASE mydb TO claude_readonly;
GRANT USAGE ON SCHEMA public TO claude_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO claude_readonly;

# my_server.py
from mcp.server.fastmcp import FastMCP
import requests
import os

mcp = FastMCP("my-internal-tools")

@mcp.tool()
def get_user_status(user_id: str) -> dict:
    """社内ユーザーシステムからユーザーの状態を取得"""
    r = requests.get(
        f"https://internal.example.com/api/users/{user_id}",
        headers={"Authorization": f"Bearer {os.environ['INTERNAL_API_TOKEN']}"},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

@mcp.tool()
def search_tickets(query: str, limit: int = 10) -> list[dict]:
    """社内チケットシステムを検索"""
    r = requests.get(
        "https://tickets.example.com/api/search",
        params={"q": query, "limit": limit},
        headers={"Authorization": f"Bearer {os.environ['TICKETS_API_TOKEN']}"},
        timeout=10,
    )
    return r.json()["results"]

if __name__ == "__main__":
    mcp.run()

claude mcp add my-internal stdio "python /path/to/my_server.py" \
  -e INTERNAL_API_TOKEN=xxx \
  -e TICKETS_API_TOKEN=yyy