Peterparker57 Project Hub MCP Server

🚀 プロジェクトセンターMCPサーバー

このMCPサーバーは、プロジェクト管理とGitHub統合機能を提供します。ローカルプロジェクトを管理し、変更を追跡し、GitHubリポジトリに同期することができます。

✨ 主な機能

• プロジェクトの作成と管理
• 変更の追跡とバージョン管理
• GitHubリポジトリの統合
• ソースファイルのスキャンと監視
• 自動コミット管理
• 複数アカウントのGitHubサポート

🛠️ ツール

プロジェクト管理

create_project

ローカルとリモートのリポジトリ管理機能を備えた新しいプロジェクトを作成します。

• name: プロジェクト名
• path: ローカルプロジェクトのパス
• type: プロジェクトのタイプ
• description: プロジェクトの説明

get_project

リポジトリ情報を含むプロジェクトの詳細情報を取得します。

• name: プロジェクト名

list_projects

すべてのプロジェクトをリスト表示し、オプションでフィルタリングできます。

• name: プロジェクト名

delete_project

指定されたプロジェクトを削除します。

• name: プロジェクト名

GitHubアカウント管理

create_repository

新しいGitHubリポジトリを作成します。

• name: リポジトリ名
• description: リポジトリの説明
• private: プライベートリポジトリかどうか（オプション）

link_repository

ローカルプロジェクトをGitHubリポジトリに関連付けます。

• project_name: プロジェクト名
• repo_owner: GitHubアカウント名
• repo_name: リポジトリ名

コミット管理

create_commit

指定されたリポジトリにコミットを作成します。

• repo: リポジトリ名
• changes: パス、操作、ソースパスを含む変更リスト
• message: コミットメッセージ

📦 インストールと設定

1. プロジェクトリポジトリをクローンします。

git clone https://github.com/yourusername/project-hub-mcp-server.git

2. 環境変数を設定します。

export DEFAULT_OWNER=your-github-username
export GITHUB_TOKEN_your-github-username=your-github-token

3. サーバーを起動します。

node dist/index.js

💻 使用例

プロジェクト管理

// 新しいプロジェクトを作成する
await mcp.use("project-hub", "create_project", {
  name: "my-project",
  path: "./projects/my-project",
  type: "typescript",
  description: "一個全新的 TypeScript 项目"
});

// 変更を記録する
await mcp.use("project-hub", "record_change", {
  project_name: "my-project",
  description: "添加新功能",
  type: "feature",
  files: ["src/feature.ts"]
});

GitHub統合

// リポジトリを作成して関連付ける
await mcp.use("project-hub", "create_repository", {
  name: "my-project",
  description: "一個全新的 TypeScript 项目",
  private: true
});

await mcp.use("project-hub", "link_repository", {
  project_name: "my-project",
  repo_owner: "your-username",
  repo_name: "my-project"
});

// コミットを作成する
await mcp.use("project-hub", "create_commit", {
  repo: "my-project",
  changes: [{
    path: "src/feature.ts",
    operation: "add",
    sourcePath: "./projects/my-project/src/feature.ts"
  }],
  message: "feat: 添加新功能"
});

🔨 開発

1. ソースコードを変更します。
2. テストを実行します。

npm test

3. プロジェクトをビルドします。

npm run build

🤝 貢献ガイド

1. リポジトリをForkします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. Pull Requestを作成します。

📄 ライセンス

MIT