mcpField
M
Mcp Server Template

Mcp Server Template

ローカル
github.com/seepine開発ツール017 週間前に更新

Mcp Server Template について

Mcp Server Templateは、MCPサーバーを作成するためのTypeScriptテンプレートです。stdio、SSE、streamable HTTPに対応し、開発時やデプロイ時に環境変数やリクエストヘッダーを利用できます。

主な機能

  1. 01stdio、SSE、streamable HTTP対応
  2. 02stdioで環境変数を取得
  3. 03HTTPモードでヘッダーを取得
  4. 04Dockerでのデプロイ

活用シーン

  1. 01MCP連携用サーバーのひな型作成
  2. 02環境変数やヘッダーを使った認証情報の受け渡し
  3. 03MCP InspectorによるSSEサーバーのテスト

MCP 対応

stdio、SSE、streamable HTTPのトランスポートを使うMCPサーバーのテンプレートです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"template-seepine": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"build"
]
}
}
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

README(原文)English

プロジェクトの README より

この README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。

Mcp Server Template

开发

1. 安装
pnpm install
2. 启动
pnpm dev
3. 调试

在弹出的 MCP Inspector 跳时网页,选择 SSE 模式并连接,SSE 支持自动重连,更好支持本地开发调试,当然你也可以选择其他模式

4. 参数传递
  • stdio 模式,可以用 process.env 获取 mcp 配置的 env 变量
  • sse/streamable-http 模式,可以用封装的 ctx.get() 获取 mcp 配置的请求头,方便鉴权等

部署 Stdio

1. 打包
pnpm build
2. 发布到 npm
pnpm publish
3. MCP 配置
{
  "mcpServers": {
    "mcp-server-template": {
      "type": "stdio",
      "command": "npx",
      "args": ["mcp-server-template"],
      "env": {
        "API_KEY": "sk-123"
      }
    }
  }
}

部署 docker

1. Build
docker build -t mcp-server-template .
2. Run the server
docker run -p 3000:3000 mcp-server-template
# 或启动 sse
docker run -p 4000:4000 mcp-server-template node sse.js
3. MCP 配置
{
  "mcpServers": {
    "mcp-server-template": {
      "type": "streamableHttp",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "api-key": "sk-123"
      }
    },
    // 或 sse
    "mcp-server-template": {
      "type": "sse",
      "url": "http://localhost:4000/mcp",
      "headers": {
        "api-key": "sk-123"
      }
    }
  }
}

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。