MCP 設定とサーバーのひな形
MCP 経由で Claude をツールに接続するための、コピー＆ペースト用スターターです。必要なものだけに削ぎ落としてください。
.mcp.json — サーバーを宣言する（プロジェクト共有）
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
}
}
}
:::warning シークレットをファイルに含めない
環境変数（${GITHUB_TOKEN}）を参照してください — コミットされるファイルにトークンをハードコードしないでください。
:::
最小構成の stdio サーバー（TypeScript）
ツールを 1 つだけ公開する小さなサーバーです。ハンドラをあなたのデータに合わせて調整してください。
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
const server = new McpServer({ name: "echo", version: "1.0.0" });
server.tool(
"echo",
{ text: z.string().describe("Text to echo back") },
async ({ text }) => ({ content: [{ type: "text", text: `You said: ${text}` }] }),
);
await server.connect(new StdioServerTransport());
最小構成の stdio サーバー（Python）
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("echo")
@mcp.tool()
def echo(text: str) -> str:
"""Echo the text back."""
return f"You said: {text}"
if __name__ == "__main__":
mcp.run() # stdio transport
サーバーを出荷する前に
- 最小権限 — 必要なデータ・操作だけに（エージェントのセキュリティ確保）。
- 入力を検証する。エラーは結果として返し、クラッシュさせないでください。
- サードパーティ製サーバーを精査する。接続する前に確認してください（サードパーティコードのレビュー）。