TypeSpec MCP Server and Emitter

TypeSpec MCP サーバーとエミッター

TypeSpec MCP サーバーは、TypeSpec を活用した独自の MCP サーバーをすばやく構築できるよう、MCP specification を実装しています。また、TypeSpec がサポートする REST API やその他のプロトコルの構築も可能にする予定ですが、現在開発中です。

このプロジェクトはパブリックプレビュー中であり、一般提供開始前に実装が大幅に変更される可能性がありますのでご注意ください。

概要

このリポジトリにはどのパッケージが含まれていますか？

現在、このリポジトリには次のパッケージが含まれています。

• mcp-server-typespec - TypeSpec を使用した MCP 拡張機能の開発を支援する MCP サーバーです。
• typespec-mcp - MCP サーバーを記述するための TypeSpec ライブラリです。たとえば、@tool デコレーターが含まれています。
• typespec-mcp-server-js - MCP ツールのサーバー実装を JavaScript で生成する TypeSpec エミッターです。
• typespec-mcp-http-server-js - リモート REST API を呼び出すためのサーバー実装を JavaScript で生成する TypeSpec エミッターです。

現在サポートされているツール

TypeSpec MCP サーバーは、次のツールを提供します。

• learnTypeSpec - TypeSpec の理解方法と記述方法に関する情報をモデルに読み込ませます。
• init - サンプルのツール実装を含む新しいプロジェクトを、現在の作業ディレクトリに作成します。
• compile - tsp compile を実行して、エミッターのアセットを生成します。
• build - 現在のプロジェクトで npm run build を実行します。

はじめに

TypeSpec MCP サーバーのインストールと実行には Node.js が必要です。まだインストールしていない場合は、こちらの手順に従ってください。

VS Code + GitHub Copilot

TypeSpec MCP サーバーは、MCP リソースの実装を生成するための TypeSpec の作成を支援します。単独でも、VS Code の TypeSpec VS Code extension と組み合わせても使用できます。

前提条件

1. VS Code の安定版または Insiders 版をインストールします。
   • 安定版
   • Insiders 版
2. GitHub Copilot と GitHub Copilot Chat の拡張機能をインストールします。
3. Node.js 20 以降をインストールします。
   • node と npm がパスに含まれていることを確認してください。
4. 空のフォルダーを VS Code で開きます。

インストール

ワンクリックインストール

以下のボタンのいずれかをクリックして、VS Code または VS Code Insiders に TypeSpec MCP サーバーをインストールします。

TypeSpec MCP サーバーをインストールしたら、GitHub Copilot のエージェントモードを選択し、ツールの一覧を更新してください。エージェントモードの詳細については、VS Code ドキュメントをご覧ください。

手動インストール

手順に沿ってインストールするには、以下の手順に従ってください。

1. .vscode/mcp.json を追加します。

{
  "servers": {
    "TypeSpec MCP Server": {
      "command": "npx",
      "args": ["-y", "mcp-server-typespec@latest"]
    }
  }
}

TypeSpec MCP サーバーをテストする

1. VS Code で GitHub Copilot を開き、エージェントモードに切り替えます
2. ツールの一覧に TypeCpec MCP Server が表示されます
3. 「init」のように、新しいプロジェクトのひな形を作成するために TypeSpec MCP サーバーを使うようエージェントに指示するプロンプトを試します。

トラブルシューティング

よくある問題やログの確認については、トラブルシューティングガイドをご覧ください。

コントリビューション

TypeSpec MCP サーバーへのコントリビューションを歓迎します。バグの修正、新機能の追加、ドキュメントの改善など、皆さまからの貢献をお待ちしています。

コントリビューションの方法について詳しくは、コントリビューションガイドをご覧ください。

行動規範

このプロジェクトでは、 Microsoft オープンソース行動規範を採用しています。 詳細については、 行動規範に関する FAQ をご覧いただくか、ご質問やご意見がございましたら [email protected]までお問い合わせください。