tree: 520983416f1b6ed7d8c6839f2b325e2d330152ce
  1. test/
  2. .gitignore
  3. index.js
  4. LICENSE
  5. package.json
  6. README.md
mcp/apache-projects-mcp/README.md

apache-projects-mcp

An MCP server for querying Apache Software Foundation project data from projects.apache.org/json.

This server provides a simple way for MCP clients to explore ASF committees, people, podlings, releases, LDAP groups, and repositories using data published by the ASF.

Features

The server currently provides tools to:

  • list and search Apache project committees
  • get detailed committee information
  • search for ASF committers and members
  • get details about a specific person by Apache ID
  • list current Incubator podlings
  • get release history for a project
  • list members of an ASF LDAP group
  • find source code repositories for a project
  • search across Apache top-level projects and podlings
  • return ASF-wide summary statistics

Data sources

All data is fetched from https://projects.apache.org/json/foundation/ and cached in memory for 6 hours.

FileDescription
committees.jsonTop-level project committees, including roster, chair, charter, and homepage
people.jsonASF committers and member status
people_name.jsonApache ID to full name mapping
groups.jsonLDAP groups, including committer and PMC memberships
podlings.jsonCurrent Apache Incubator podlings
releases.jsonProject release history
repositories.jsonSource code repository URLs

Available tools

ToolDescription
list_committeesBrowse or search project committees by name or keyword
get_committeeGet full PMC details, including roster, charter, and homepage
search_peopleSearch for ASF committers and members by Apache ID or name
get_personGet details for a specific ASF person, including groups and PMC memberships
list_podlingsList current incubating projects
get_releasesGet release history for a project
get_group_membersList members of an ASF LDAP group
get_repositoriesFind repositories for a project
search_projectsSearch across top-level projects and podlings
project_statsReturn ASF-wide summary statistics

Requirements

  • Node.js 20 or later
  • An MCP-compatible client

Installation

Clone the repository and install dependencies:

git clone https://github.com/rbowen/apache-projects-mcp.git
cd apache-projects-mcp
npm install

Running the server

Run the server over stdio:

npm start

You can also run it directly:

node index.js

Example MCP client configuration

Example stdio configuration:

{
  "command": "node",
  "args": ["/Users/yourname/apache-projects-mcp/index.js"]
}

Adjust the path to match your local checkout.

Example questions

Once configured in an MCP client, you can ask things like:

  • “List projects related to data or storage”
  • “Show me the PMC roster for Iceberg”
  • “Find ASF committers named Justin”
  • “What releases has Apache Spark had recently?”
  • “Which repositories match Kafka?”
  • “Search Apache projects related to security”

Notes and limitations

  • Data comes from projects.apache.org/json, not directly from Git repositories, mailing lists, or podling status reports.
  • Podling data is limited to the current contents of podlings.json.
  • Data is cached for 6 hours in memory, so updates on the source side may not appear immediately.