🚀 Civicnet MCP Server – Model Context Protocol

🚀 Civicnet MCP サーバー – Model Context Protocol

公式オープンソース MCP サーバーへようこそ。
これは、Konstellation と CivicNet の連合型市民インフラの中核です。地域に根ざした、信頼できるエージェント型コミュニティ AI を実行するための、モジュール式で原則を重視したサーバーです。

---

🧭 MCP サーバーとは？

MCP サーバーは、CivicNet/Konstellation グリッドにおける**近隣、都市、組織レベルの「ノード」**を支えます。各ノードは次の機能を備えています。

• 地域データ（GIS、政策、コミュニティの物語、公開記録）を取り込み、検証します
• エージェント型モデル（推論、自己監査、シミュレーション、ロールプレイなど）をホストし、オーケストレーションします
• すべてのクエリと出力に市民原則（公平性、真実性、プライバシー、透明性）を適用します
• ダッシュボード、GIS クライアント、外部パートナー向けに、安全で文書化された API を公開します
• 他の MCP ノードと連携してナレッジを共有しながら、地域の管理権を維持します

なぜ必要なのでしょうか？
すべてのコミュニティが、自らの市民インテリジェンスを所有し、管理し、継続的に改善できるようにするためです。ブラックボックスも、ベンダーロックインも、気づかれないバイアスもありません。

---

🌌 主な機能

• LLM 非依存： 最新のあらゆる言語モデル（OpenAI、Anthropic、オープンソース）を接続できます
• クラウド非依存： クラウド、オンプレミス、エッジ、またはローカルデバイスにデプロイできます
• 原則リポジトリ： コミュニティの原則をコードで定義、監査、発展させることができます
• モジュール式エージェントロジック： 思考の連鎖、自己省察、ロールシミュレーション、マルチエージェントによる討論などに対応します
• データ管理： 地域のデータ、オープンデータ、連合型の市民データに対応するきめ細かなコネクターを備えています
• シミュレーション対応： 「もしも」のシナリオや参加型シミュレーションを実行できます
• 完全な監査証跡： すべての出力、エージェントの処理段階、データソースが記録され、確認できます
• Docker 化： ローカルでも分散環境でも、簡単にコンテナーをセットアップできます

---

🗃 ディレクトリ概要

フォルダー	用途
src/agents	エージェント型モデル（推論、アライメント、シミュレーション）
src/api	クエリ、データ、ツール向けの REST/GraphQL API
src/principles	原則リポジトリ（YAML/JSON ＋ ロジック）
src/data	データの取り込み、検証、コネクター
src/prompts	プロンプトのテンプレートとシナリオスクリプト
src/simulation	シミュレーション、シナリオのモデリングロジック
src/utils	ロギング、監査、ヘルパー関数
config/	ノード設定、有効化する機能、.env テンプレート
scripts/	開発、テスト、移行用スクリプト
tests/	単体テストと統合テスト

---

⚡️ クイックスタート（ローカル Docker Compose）

1. リポジトリをクローンします：

   git clone https://github.com/PublikPrinciple/civicnet-mcp-server.git
   cd civicnet-mcp-server
   

2. 環境変数をコピーして編集します：

   cp config/.env.example .env
   # Edit .env with your API keys, DB, LLM settings, etc.
   

3. MCP サーバー（および任意のデータサービス）を起動します：

   docker-compose up --build
   

4. API ドキュメントを表示します：

   • http://localhost:4000/docs にアクセスします（デフォルトでは Swagger/OpenAPI）

---

🛠️ 基本概念

原則リポジトリ

• すべての出力は、コミュニティの基本原則（例：「公平性を確保する」「危害を避ける」「情報源を引用する」）に沿うよう、確認、フィルタリング、または書き換えられます。
• /src/principles/ 内の YAML/JSON を使って原則を更新します。

エージェントとエージェントロジック

• 思考の連鎖エージェント： 透明性を高めるための段階的なロジック
• 自己省察エージェント： 自身のバイアス、ロジック、コンプライアンスを確認します
• ロールシミュレーションエージェント： 討論（計画担当者対住民）、専門家パネル、歴史的視点をシミュレートします
• マルチエージェント連携： シナリオテスト、参加型予算編成、レッドチーミングに対応します
• 各エージェントのロジックはモジュール式で組み合わせ可能です（/src/agents/ を参照）。

データレイヤー

• GIS、国勢調査、地域の CSV、API などに対応するコネクター
• プライバシーとデータの衛生管理のための検証／墨消しステップ
• 連携： 信頼できるノードと共有／選択的に共有できます（オプトイン）

プロンプトとシナリオのテンプレート

• エージェントによる推論はすべて、プロンプトテンプレートによって実行されます（/src/prompts/ を参照）
• 独自のテンプレートを作成するか、組み込みの市民事例研究およびシミュレーション用テンプレートを使用します

シミュレーション

• 実データと合成データを使用して、「もしも」の未来（住宅、気候、予算など）をモデル化します
• 出力はインタラクティブで、原則に基づく監査を受けています

---

🔑 使用例

• 地図、タイムライン、公平性分析を含み、GIS と一般公開レビューにすぐ使える「ダーラム住宅危機」のケーススタディを生成する
• 地域住民のエージェント同士のロールプレイ形式の議論を通じて、参加型予算編成のシミュレーションを支援する
• 地域のダッシュボード向けに、平易な言葉で原則に沿ったデータ API を公開する
• すべての出力について、バイアス、誤り、コミュニティの原則に照らして監査する（ログとフィードバックを含む）
• 他の近隣地域や都市と連携し、地域分析を比較、再構成、改善する

---

🧑‍💻 開発者向け

• 言語： デフォルトでは TypeScript/Node.js を使用し、Python エージェントとの互換性はロードマップにあります
• コントリビューション： ブランチ運用、コードスタイル、原則への準拠を確認する PR チェックについては、CONTRIBUTING.md を参照してください
• テスト： npm test（Jest）、または docker-compose -f docker-compose.test.yml up を実行してすべてのテストを実行します

---

🏛️ 市民データ管理者向け

• 原則主導のガバナンス： /src/principles/ を編集して、ノードの価値観を更新します
• ログと監査： すべての回答を追跡できます（誰が質問したか、どのデータを使ったか、どのエージェントを使用したか、どのチェックを行ったか）
• オープン API： MCP サーバーのエンドポイントを利用して、独自の GIS クライアント、ダッシュボード、またはモバイルアプリを構築できます

---

🔒 セキュリティとプライバシー

• 明示的な原則に基づく同意と匿名化なしに、機密データが共有または公開されることはありません
• 各ノードはサンドボックス化されており、フェデレーションは常にオプトイン方式で、監査可能です

---

🌍 フェデレーションとコンステレーション

• Konstellation 対応： このサーバーはフェデレーションを前提に設計されており、地域のガバナンスとプライバシーを完全に維持しながら、他のコミュニティ、都市、地域と知見を公開・共有できます
• フェデレーションクエリ： 比較を可能にします（例：「すべての近隣地域の立ち退き率を表示する」）

---

📖 ドキュメントとコミュニティ

• 完全なドキュメントは /docs/ または civicnet.org/docs へのリンク にあります
• サポートやディスカッションについては、Discord の #mcp-server チャンネルに参加してください

---

📝 ライセンス

AGPL 2.0 – オープンで、再構成可能、コミュニティ主導です
詳細は LICENSE を参照してください

---

✨ 市民インフラの未来の構築を始めましょう！

---

📘 Swagger/OpenAPI のセットアップ（API エンドポイントの概要）

/src/api/routes.ts に以下を追加します（サンプル）：

import express from 'express'; import swaggerUi from 'swagger-ui-express'; import YAML from 'yamljs';

const router = express.Router(); const swaggerDocument = YAML.load('./config/swagger.yaml');

router.use('/docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument)); export default router;

swagger.yaml のスターターサンプル：

openapi: 3.0.0 info: title: MCP サーバー API version: 1.0.0 paths: /api/analyze: post: summary: エージェント型ロジックを使用して市民向けクエリを分析する requestBody: required: true content: application/json: schema: type: object properties: query: type: string context: type: object responses: '200': description: 分析が完了しました