Andrewdonelson Go MCP Server Service

🚀 GoベースのMCPサーバーサービス

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

✨ 主な機能

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

📚 詳細ドキュメント

コンポーネント

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

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

サービス (service)

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

リソース

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

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

ヒント

利用可能なヒント：

• summarize - notes: すべての保存されたノートの要約を作成します。
  • オプションパラメータ：style（"brief"/"detailed"）
  • 現在のすべてのノートを結合し、スタイルの好みに応じて結果を表示します。
  • スレッドセーフなノートアクセス

ツール

利用可能なツール：

• 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/
• リリースビルド：dist/

設定

設定ファイルは以下の場所で見つけることができます。

$XDG_CONFIG_HOME/mcnotes.json

デフォルトでは、これは以下に相当します。

~/.config/mcnotes.json

プロジェクト構造図

.
├── README.md               # プロジェクトの説明ドキュメント
├── go.mod                 # Goモジュールファイル
├── go.sum                 # Go依存関係のチェックと認証ファイル
├── cmd/
│   ├── add - note/
│   │   └── main.go       # ノートを追加するメインプログラム
├── service/
│   └── server.go         # サーバーの実装
└── resources/
    └── note_manager.go   # ノートマネージャー

設定例

{
  "debug": false,
  "port": 8080,
  "database": {
    "driver": "sqlite3",
    "path": "notes.db"
  }
}

エラーコード

以下は可能なエラーコードです。

📄 ライセンス

このプロジェクトはMIT Licenseの下でオープンソースとして公開されています。

その他の質問がある場合は、公式ドキュメントを参照してください。