Skip to content

zhuaiballl/mcp_collection

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCP Collection

A research-purpose collection of Model Context Protocol (MCP) clients, servers, and related utilities.


📌 Project Overview

This project provides:

  • Metadata for MCP clients and servers
  • Utility scripts for processing and managing MCP resources
  • Tools for cloning, merging, and analyzing MCP repositories

📂 Project Structure

metadata/
  clients/               # Metadata for MCP clients
    glama_client.json
    mcp_so_client.json
    merged_clients.json
    ...
    xlsx/                # Excel files with client data

  servers/               # Metadata for MCP servers
    awesome.json
    glama.json
    merged_servers.json
    ...
    xlsx/                # Excel files with server data

scripts/
  clients/               # Scripts for client processing
    convert_glama_client.py
    convert_xlsx_to_json.py
    ...
  clone_repos_from_json.py   # Clone GitHub repos from JSON metadata
  merge_json.py              # Merge JSON metadata files
  normalize_github_urls.py   # Normalize GitHub URLs
  remove_duplicates.py       # Remove duplicate entries
  ...

🧩 Key Components

1. Metadata

Structured JSON information about MCP clients and servers.
Complete list of clients Complete list of servers


2. Scripts

Clone Repositories

clone_repos_from_json.py – Clones GitHub repositories from JSON metadata.

export GITHUB_TOKEN="YOUR_GITHUB_ACCESS_TOKEN" && python scripts/clone_repos_from_json.py <input_json_file> <output_directory>

Process:

  1. Read GitHub URLs from the JSON file
  2. Validate and normalize URLs
  3. Clone repositories to the output directory
  4. Append counters to duplicate names
  5. Log failed clones to clone_failed.txt

Merge JSON Files

merge_json.py – Merges two JSON metadata files (paths currently hard-coded).

python scripts/merge_json.py

Analyze Repos

enhanced_repo_analysis.py - Run some analysis on GitHub repos.

python scripts/enhanced_repo_analysis.py clone <json_file_path> <output_directory>
python scripts/enhanced_repo_analysis.py analyze --repo-dir ../mcp_servers --output-dir analysis

📜 License

This project is licensed under the MIT License.

About

A dataset for Model Context Protocol (MCP) servers, clients, etc.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages