This is an automated email from the ASF dual-hosted git repository. rbowen pushed a commit to branch rbowen-apache-projects-mcp in repository https://gitbox.apache.org/repos/asf/comdev.git
commit 3ed42cd852518b9079454f04424a2db79192a721 Author: Rich Bowen <[email protected]> AuthorDate: Sat Apr 18 08:08:01 2026 -0400 first commit --- README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/README.md b/README.md new file mode 100644 index 0000000..f5f87d3 --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ +# apache-projects-mcp + +MCP server for querying Apache Software Foundation project data from [projects.apache.org/json/](https://projects.apache.org/json/). + +## Data Sources + +All data is fetched from `https://projects.apache.org/json/foundation/` and cached for 6 hours: + +| File | Description | +|------|-------------| +| `committees.json` | All TLP committees — roster, chair, charter, homepage | +| `people.json` | All ASF committers — groups, member status | +| `people_name.json` | Apache ID → full name mapping | +| `groups.json` | LDAP groups — committer and PMC membership lists | +| `podlings.json` | Current Incubator podlings | +| `releases.json` | Release history per project | +| `repositories.json` | Source code repository URLs | + +## Tools + +| Tool | Description | +|------|-------------| +| `list_committees` | Browse/search PMCs by name, description, or charter | +| `get_committee` | Full PMC detail: roster, chair, charter, homepage | +| `search_people` | Find committers by Apache ID or name | +| `get_person` | Full detail on a person: groups, PMC memberships, member status | +| `list_podlings` | Current incubating projects | +| `get_releases` | Release history for a project | +| `get_group_members` | List members of an LDAP group (committer or PMC) | +| `get_repositories` | Find repos for a project | +| `search_projects` | Unified search across TLPs and podlings | +| `project_stats` | ASF-wide summary statistics | + +## Setup + +```bash +cd ~/devel/apache-projects-mcp +npm install +``` + +## Usage (stdio) + +```bash +node index.js +``` + +## Amazon Quick Configuration + +Add to your MCP server config: + +```json +{ + "command": "node", + "args": ["/Users/rcbowen/devel/apache-projects-mcp/index.js"] +} +```
