MCP Server
mcp-charity
conorheffron/mcp-charity
57
BomPluginScore · de 0 a 100Sample MCP server used to expose charity information in a flexible manner.
Instalação
$
npx convez-ai conorheffron/mcp-charity1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Estrelas
4Forks
0Acompanhando
0Saúde
57%Último commit
há 1 semanaVersão
1.0.7Issues abertas
5Contribuidores
2README
A tradução para o português deste README ainda está na fila.
mcp-charity
Tech
- Python 3.14, PyCharm, pipenv, fastmcp 3, Postman
Quick Start
Install Dependencies
pipenv --python 3.14
sudo pipenv run pip install -r requirements.txt
sudo pipenv shell
Start MCP Server with FASTMCP (transport=STDIO, for CLI interface instead of HTTP / Postman)
pipenv run fastmcp run charity_server.py
Start MCP Server for Testing with recommended python init main process
pipenv run python3 charity_server.py
Testing
Test via CLI with curl (Note: Allows for sub string search values - direct match not required!)
curl --request POST \
--url http://localhost:8000/mcp \
--header 'accept: application/json, text/event-stream' \
--header 'content-type: application/json' \
--header 'mcp-session-id: my-test-session-124' \
--data '{ "method": "tools/call",
"params": {
"name": "query_charities",
"arguments": {
"charity_name": "",
"location": "Gal",
"cause": ""
}
},
"jsonrpc": "2.0",
"id": 9}'
Response from curl
event: message
data: {
"jsonrpc": "2.0",
"id": 9,
"result": {
"content": [
{
"type": "text",
"text": "[{\"name\":\"Irish Cancer Society\",\"location\":\"Galway\",\"cause\":\"Health\"}]"
}
],
"isError": false
}
}
Use Postman to connect & tests available app tools / end-points
- Connect to MCP end-point
/mcp - The test available tools, in this case, try
query_charitiestool




HTTP Endpoint
Corresponding Logs

Request Body for POST request to query_charities tool
curl --request POST \
--url http://localhost:8000/mcp \
--header 'accept: application/json, text/event-stream' \
--header 'content-type: application/json' \
--header 'mcp-session-id: my-test-session-124' \
--data '{ "method": "tools/call",
"params": {
"name": "query_charities",
"arguments": {
"charity_name": "",
"location": "",
"cause": "Animals" }
},
"jsonrpc": "2.0",
"id": 9 }'
Curl Response Body (Formatted where isError == false)
event: message
data: {
"jsonrpc": "2.0",
"id": 9,
"result": {
"content": [
{
"type": "text",
"text": "[{\"name\":\"Dogs Trust\",\"location\":\"Dublin\",\"cause\":\"Animals\"}]"
}
],
"isError": false
}
}
Request Body for POST request to query_charities tool with invalid argument
curl --request POST --url http://localhost:8000/mcp --header 'accept: application/json, text/event-stream' --header 'content-type: application/json' --header 'mcp-session-id: my-test-session-124' --data '{ "method": "tools/call",
"params": { "name": "query_charities",
"arguments": {
"causes": "9"
}
},
"jsonrpc": "2.0",
"id": 9}'
ERROR Response (isError == true)
event: message
data: {
"jsonrpc": "2.0",
"id": 9,
"result": {
"content": [
{
"type": "text",
"text": "1 validation error for call[query_charities]\ncauses\n Unexpected keyword argument [type=unexpected_keyword_argument, input_value='9', input_type=str]\n For further information visit https://errors.pydantic.dev/2.12/v/unexpected_keyword_argument"
}
],
"isError": true
}
}