MCP TypeScript Demo Server
Provides tools for searching academic papers on arXiv by topic and extracting detailed information about specific papers by their ID.
Employs .env file for environment configuration, specifically for storing the Anthropic API key.
Leverages Node.js runtime environment to execute the MCP server functionality, with v16 or higher required.
Implements the MCP server using TypeScript for type safety and modern JavaScript features.
Uses Yarn package manager for dependency management and script execution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP TypeScript Demo Server search for recent papers about large language models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Demo - TypeScript Implementation
This is a TypeScript implementation of the MCP: Build Rich-Context AI Apps with Anthropic course from DeepLearning.AI.
Overview
This project demonstrates the Model Context Protocol (MCP) implementation with streamable HTTP capabilities. MCP is an open protocol that standardizes how LLM applications can access context through tools and data resources using a client-server architecture.
⚠️ This project is for educational and demo purposes only.
Related MCP server: NewsDigest MCP
Features
MCP client-server architecture implementation
Streamable HTTP communication
arXiv paper search functionality
Paper information extraction
Tool selection and argument extraction
Prompt template management
Prerequisites
Node.js (v16 or higher)
Yarn package manager
Anthropic API key
Setup
Clone the repository
git clone <repository-url> cd mcp-demoInstall dependencies
yarn installEnvironment Configuration
Create a
.envfile in the root directory:ANTHROPIC_API_KEY=<your_anthropic_api_key_here>Important: Replace
<your_anthropic_api_key_here>with your actual Anthropic API key.Build the project
yarn build
Project Structure
mcp-demo/
├── src/
│ ├── client.ts # MCP client implementation
│ ├── server.ts # MCP server implementation
│ └── index.ts # Core functionality and utilities
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── yarn.lock # Locked dependencies
└── README.md # This fileUsage
Starting the MCP Server
yarn start:serverStarting the MCP Client
yarn start:clientRunning Both (Development)
yarn devAvailable Tools
The MCP server provides the following tools:
search_papers- Search for papers on arXivArguments:
topic(string): The topic to search formax_results(number, optional): Maximum number of results (default: 5)
extract_info- Extract information from a specific paperArguments:
paper_id(string): The ID of the paper to look for
API Reference
search_papers(topic: string, max_results?: number)
Searches for papers on arXiv based on a topic and returns their information.
extract_info(paper_id: string)
Searches for information about a specific paper by ID from arXiv.
getToolSelectionPrompt(toolList: string, userQuery: string)
Generates a detailed prompt for tool selection and argument extraction.
Course Reference
This implementation is based on the MCP: Build Rich-Context AI Apps with Anthropic course by DeepLearning.AI in partnership with Anthropic. The course covers:
Core concepts of MCP
Client-server architecture
Building MCP-compatible applications
Connecting to third-party servers
Deploying MCP servers remotely
For the complete course content, visit: https://learn.deeplearning.ai/courses/mcp-build-rich-context-ai-apps-with-anthropic
Contributing
This is a demo project for educational purposes. Feel free to experiment and modify the code to learn more about MCP implementation.
License
This project is for educational purposes only. Please refer to the original course materials for licensing information.
Support
For questions about the MCP protocol or the original course, please refer to:
Available Tools
2 toolsget_current_dateB
获取当前日期, 如果用户没有提供日期, 则返回当前日期, 如果用户提供的是相对单位, 如前天, 昨天, 明天, 则返回相对单位后的日期
Inputs: date (required).
get_current_weatherC
Get weather info for a given city.
Inputs: city (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one handles date calculations and the other provides weather information. There is no overlap in functionality, making it impossible to confuse them.
Both tools follow a consistent 'get_current_*' naming pattern, which clearly indicates their purpose. The minor deviation is that one description is in Chinese and the other in English, but the naming structure itself is uniform.
With only two tools, this server feels thin and under-scoped for a general-purpose demo. It lacks the depth or breadth expected for a meaningful toolset, making it appear incomplete or trivial.
The server covers two unrelated domains (date and weather) but lacks any cohesive scope. There are significant gaps in both domains—no date manipulation beyond basic relative units and no weather-related operations like forecasts or historical data—making it feel like a random collection rather than a complete surface.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
GitHub trending repos, HuggingFace trending AI models & arXiv academic paper search remote MCP API.
41GitHub trending repos, HuggingFace trending AI models & arXiv academic paper search remote MCP API.
41
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI agents to search, retrieve, and analyze academic papers from arXiv, supporting features like keyword search, paper details retrieval, content extraction, and paper analysis.6MIT
- AlicenseAqualityDmaintenanceA TypeScript-based Model Context Protocol server that fetches, searches, and formats news articles from NewsAPI.org into reader-friendly Markdown digests using LLMs (Gemini and Claude).12ISC
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables natural language interaction with arXiv.org, allowing users to search, retrieve metadata, download PDFs, and load scholarly articles into LLM context.541MIT
- FlicenseNot gradedqualityDmaintenanceA Python implementation of the Model Context Protocol (MCP) server that enables searching and extracting information from arXiv papers, designed to be extensible with additional MCP tools.-