Go MCP Server Service

🚀 Go ベースの MCP サーバー（notes-server）

このサーバーは JSON-RPC 2.0 標準に準拠しており、モデルコンテキストプロトコル (MCP) のノート管理をサンプル形式で実装しています。これはサンプルであり、自由に修正して独自のプロジェクトのテンプレートとして使用できます。クロスプラットフォーム開発をサポートし、開発とリリースのビルド設定、コマンドラインインターフェイス、サービスコンポーネントが含まれています。

✨ 主な機能

• JSON-RPC 2.0 標準インターフェイス
• クロスプラットフォーム対応（Windows、Linux、macOS）
• スレッドセーフなノート管理
• 開発とリリースのビルド設定
• サービスとコマンドラインインターフェイスコンポーネント

📚 詳細ドキュメント

コンポーネントモジュール

コマンドラインインターフェイス (cmd)

コマンドラインインターフェイスは、サーバーの機能に直接アクセスできるようにします。

サービス (service)

サービスコンポーネントは、システムレベルの統合とバックグラウンド実行機能を実装しています。

リソース管理

サーバーはノートストレージシステムを実装しており、以下を含みます。

• 単一のノートにアクセスするためのカスタム note:// URI スキーム
• リソースメタデータ（名前、説明、MIME タイプ）
• スレッドセーフな並行アクセス

提示機能

利用可能な提示コマンド：

• summarize-notes: すべての保存されたノートの要約を作成します。
  • オプションパラメータ：style（"簡潔"/"詳細"）
  • スタイルの好みに基づいてすべての現在のノートを結合します。
  • スレッドセーフなノートアクセス

ツール機能

利用可能なツールコマンド：

• add-note: サーバーに新しいノートを追加します。
  • 必須パラメータ：name（文字列）、content（文字列）
  • スレッドセーフな状態更新
  • 確認メッセージを返します。

ビルド手順

前提条件

• Go 1.21 以上
• GNU Make または互換性のあるビルドツール
• Git（バージョン情報の取得用）

ビルドコマンド

開発ビルド（デバッグシンボルと競合検出を含む）：

# すべてのコンポーネントをすべてのプラットフォーム向けにビルド
make dev

# 特定のプラットフォーム向けにビルド
make dev-windows
make dev-linux
make dev-darwin

# 特定のコンポーネントをビルド
make build-cmd
make build-service

リリースビルド（最適化され、シンボルが削除される）：

# すべてのコンポーネントをすべてのプラットフォーム向けにビルド
make release-all

# 特定のプラットフォーム向けにビルド
make release-windows
make release-linux
make release-darwin

ローカルで実行：

# コマンドラインインターフェイスを実行
make run-cmd

# サービスを実行
make run-service

すべてのターゲットオプションを表示：

make help

ビルド出力

バイナリファイルは bin ディレクトリに作成されます。

• 開発ビルド：bin/dev/
• リリースビルド：bin/release/

設定ガイド

Claude Desktop 用の設定

コマンドラインインターフェイスで設定するには、以下のコマンドを実行します。

# MCP アドレスを設定
export MCP_ADDR="http://localhost:8080"

# MCP 認証トークンを設定
export MCP_TOKEN="your_token_here"

開発ガイド

プロジェクト構造

プロジェクトのフォルダ構造は次のとおりです。

notes-server/
├── cmd/
│   ├── main.go         # コマンドラインエントリポイント
│   └── service.go      # サービス実装
├── internal/
│   ├── handlers/       # リクエスト処理ロジック
│   └── models/         # データモデル定義
└── go.mod              # モジュール依存管理ファイル

デバッグとログ

デバッグモードを有効にするには、実行時に環境変数を設定します。

# デバッグモードを有効にする
export DEBUG=true

デフォルトでは、サービスは標準エラーストリームにログを出力します。

エラーコード定義

以下は MCP サービスが返すエラーコードです。

注意事項

⚠️ 重要提示

1. 本番環境では、適切なファイアウォールとセキュリティポリシーを設定してください。
2. 環境変数を使用して機密情報を管理し、直接ハードコードしないでください。
3. 定期的にデータをバックアップして、予期しないデータ損失を防いでください。